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Sir: 

This is an Appeal Brief under Rule 41.37 appealing the decision of the Primary 
Examiner dated August 4, 2010 (the "final Office Action" or "Action"). Each of the topics 
required by Rule 41.37 is presented herewith and is labeled appropriately. 
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I. Real Party in Interest 

The inventors have assigned their interests in the present application to International 
Business Machines Corporation ("IBM"), which has a principal place of business at New 
Orchard Road, Armonk, NY 10504. Accordingly, the real party in interest is IBM. 
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II. Related Appeals and Interferences 

There are no appeals or interferences related to the present application of which the 
Appellant is aware. 
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III. Status of Claims 

Claims 1-16 have been previously cancelled without prejudice or disclaimer. 

Claims 17-30 are pending in the application and stand finally rejected. 

Accordingly, Appellant appeals fi-om the final rejection of claims 17-30, which claims 

are presented in the Appendix. 
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rv. Status of Amendments 

No amendments have been filed subsequent to the Office Action of August 4, 2010, 
from which Appellant takes this appeal. 
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V. Summary of Claimed Subject Matter 

A summary is given below of the subject matter recited in each of the independent 
claims at appeal. The citation to passages in the specification and drawings for each claim 
element does not imply that the limitations from the cited passages in the specification and 
drawings should be read into the corresponding claim elements. See Superguide Corp. v. 
DirecTV Enterprises, Inc., 358 F.3d 870, 875, 69 USPQ2d 1865, 1868 (Fed. Cir. 2004); 
M.P.E.P. § 21 1 1.01(11). Citations to one or more line numbers in connection with a specific 
paragraph refer to the lines within that paragraph, and not necessarily to the lines in the page 
where that paragraph appears. 

Turning to Appellant's specific claims. 

Claim 17 recites: 

A method for a registry of business entity definitions to handle user requests to access 
business entity definitions, the method comprising: 

receiving a request (511, Fig. 5) in a processor (101, Fig. 1) associated with said 
registry (302, Fig. 5) from a user to access a business entity definition (201, Fig. 4) {e.g., 
Appellant's specification, p. 5 lines 21-37, p. 10 lines 28-13, p. 1 1 lines 32-34, p. 12 lines 24- 
33, Figs. 4-6) comprising a plurality of information elements (201, 203, 206, Fig. 4) {e.g.. 
Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6), each of said information 
elements (201, 203, 206, Fig. 4) having permission details (401, 402, 404, Fig. 4) associated 
therewith {e.g.. Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); 

obtaining the identity of the user from data associated with the request (511, Fig. 5) 
with said processor (101, Fig. 1) {e.g.. Appellant's specification, p. 10 lines 35-37, p. 11 lines 
35-37, Figs. 4-6); 
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determining with said processor (101, Fig. 1), for each of said information elements 
(201, 203, 206, Fig. 4), whether the user has permission to access that said information 
element (201, 203, 206, Fig. 4) based on the permission details (401, 402, 404, Fig. 4) 
associated with that said information element (201, 203, 206, Fig. 4) and said identity of the 
user (e.g., Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); and 

with said processor (101, Fig. 1), denying the user access to those information 
elements (201, 203, 206, Fig. 4) for which it is determined that the user does not have 
permission (e.g., Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6). 

Claim 21 recites: 

A registry (302, Fig. 3) of business entity definitions, the registry comprising: 

at least one processor (101, Fig. 1) (e.g.. Appellant's specification, p. 5 lines 21-37, p. 
12 lines 24-33, Fig. 1); and 

a computer readable memory (102, 103, Fig. 1) communicatively coupled to said 
processor (101 , Fig. 1) having said business entity definitions stored thereon (e.g.. 
Appellant's specification, p. 5 lines 21-37, p. 12 lines 24-33, Fig. 1); 

wherein said processor (101, Fig. 1) is configured to: 

receive a request (511, Fig. 5) from a user to access a business entity 
definition (201, Fig. 4) comprising a plurality of information elements (201, 203, 206, Fig. 4) 
(e.g., Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6), each of said information 
elements (201, 203, 206, Fig. 4) having permission details (401, 402, 404, Fig. 4) associated 
therewith (e.g., Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); 

obtain the identity of the user from data associated with the request (511, Fig. 
5) (e.g.. Appellant's specification, p. 10 lines 35-37, p. 1 1 lines 35-37, Figs. 4-6); 
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determine, for each of said information elements (201, 203, 206, Fig. 4), 
whether the user has permission to access that said information element (201, 203, 206, Fig. 
4) based on the permission details (401, 402, 404, Fig. 4) associated with that said 
information element (201, 203, 206, Fig. 4) and said identity of the user (e.g.. Appellant's 
specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); and 

deny the user access to those information elements (201, 203, 206, Fig. 4) for 
which it is determined that the user does not have permission (e.g., Appellant's specification, 
p. 8 line 6 to p. 9 line 37, Figs. 4-6). 

Claim 27 recites: 

A computer program product for a registry of business entity definitions to handle 
user requests to access business entity definitions, the computer program product comprising: 

a computer readable storage medium (102, 103, Fig. 1) having computer usable 
program code embodied thereon (e.g., Appellant's specification, p. 5 lines 21-37, p. 12 lines 
24-33, Fig. 1), the computer usable program code comprising: 

computer usable program code configured to receive a request (511, Fig. 5) 
from a user to access a business entity definition (201, Fig. 4) comprising a plurality of 
information elements (201, 203, 206, Fig. 4) (e.g., Appellant's specification, p. 8 line 6 to p. 
9 line 37, Figs. 4-6), each of said information elements (201, 203, 206, Fig. 4) having 
permission details (401, 402, 404, Fig. 4) associated therewith (e.g., Appellant's 
specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); 

computer usable program code configured to obtain the identity of the user 
from data associated with the request (511, Fig. 5) (e.g.. Appellant's specification, p. 10 lines 
35-37, p. 1 1 lines 35-37, Figs. 4-6); 
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computer usable program code configured to determine, for each of said 
information elements (201, 203, 206, Fig. 4), whether the user has permission to access that 
said information element (201, 203, 206, Fig. 4) based on the permission details (401, 402, 
404, Fig. 4) associated with that said information element (201, 203, 206, Fig. 4) and said 
identity of the user (e.g.. Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6); and 

computer usable program code configured to deny the user access to those 
information elements (201, 203, 206, Fig. 4) for which it is determined that the user does not 
have permission (e.g., Appellant's specification, p. 8 line 6 to p. 9 line 37, Figs. 4-6). 
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VI. Grounds of Rejection to be Reviewed on Appeal 
The Office Action raised the following grounds of rejection. 

(1) Claims 21-26 stand rejected under 35 U.S.C. § 1 12, first paragraph, as 
allegedly failing to comply with the written description requirement. 

(2) Claims 21-26 stand rejected under 35 U.S.C. § 1 12, first paragraph, allegedly 
failing to comply with the enablement requirement. 

(3) Claims 17-30 stand rejected under 35 U.S.C. § 1 12, second paragraph, as 
being allegedly indefinite. 

(4) Claims 17, 21, and 27 stand rejected under 35 U.S.C. § 102(b) as being 
allegedly anticipated by U.S. Patent No. 5,414,852 to Kramer et al. ("Kramer"). 

(5) Claims 19-20, 23-24, and 29-30 stand rejected under 35 U.S.C. § 103(a) as 
being allegedly obvious over Kramer in view of U.S. Patent No. 5,629,980 to Stefik et al. 
("Stefik"). 

(6) Claims 18, 22, 25-26, and 28 stand rejected under 35 U.S.C. § 103(a) as being 
allegedly obvious over Kramer in view of U.S. Patent Application Publication No. 
2002/0046157 by Solomon ("Solomon"). 

(7) Claims 17, 21, and 27 stand alternately rejected under 35 U.S.C. § 103(a) as 
being allegedly obvious over Kramer in view of Stefik. 

Accordingly, Appellant hereby requests review of each of these grounds of rejection 
in the present appeal. 
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VII. Argument 

The claims do not stand or fall together. Instead, Appellant presents separate 
arguments for various independent and dependent claims. Each of these arguments is set 
forth below with separate headings and subheadings as required by 37 C.F.R. § 
41.37(c)(l)(vii). 

(1) Claims 2 1-26 comply with the written description requirement of 35 U.S.C. § 1 12. 
first paragraph. 

Claims 21-26 stand rejected under 35 U.S.C. § 1 12, first paragraph, as allegedly 
failing to meet the written description requirement. For at least the following reasons, this 
rejection is improper and should be reversed. 

A. "At least one Processor" 

According to the final Office Action, claim 21 fails to meet the written description 
requirement of 35 U.S.C. § 1 12, first paragraph because it recites a registry comprising "at 
least one processor," where the specification only teaches a single-processor embodiment. 
(Action, p. 2). The Examiner asserts that "[b]ecause Appellants did not disclose multiple 
processors in their original disclosure, the limitation "at least one processor," which claims 
registries with more than one processor, is new matter." (Id). This assertion is erroneous on 
multiple levels. 

In the first place, Appellant notes that the claimed term "at least one processor" does 
not require multiple processors, as the Examiner asserts. A registry with only a single 
processor is a registry with "at least one processor." (Claim 21). As such. Appellant's 
specification and drawings clearly teach a registry system with "at least one processor." (Id.; 
Appellant's specification, p. 5 line 21 to p. 7 line 13, p. 10 line 28 to p. 12 line 33, Figs. 1-6). 
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The Manual for Patenting Examination and Procedure (M.P.E.P.) has embraced the 
tests of the Federal Circuit for determining whether subject matter complies with the written 
description requirement. See M.P.E.P. § 2163.03. For example, a claim complies with the 
written description requirement if "the description clearly allow[s] persons of ordinary skill 
in the art to recognize that he or she invented what is claimed." In re Gosteli, 872 F.2d 1008, 
1012, 10USPQ2d 1614, 1618 (Fed. Cir. 1989); id. (quoting Gosteli). 

More recent decisions by the Federal Circuit follow the same vein. In Ariad 

Pharmaceuticals, Inc. v. Eli Lilly and Co., the Federal Circuit states that 

the hallmark of written description is disclosure ... the test requires an objective 
inquiry into the four comers of the specification from the perspective of a person of 
ordinary skill in the art. Based on that inquiiy, the specification must describe an 
invention understandable to that skilled artisan and show that the inventor actually 
invented the invention claimed. 
598 F.3d 1336, 1351 (Fed. Cir. 2010) {en banc). 

Applying this standard to claim 21, it will be readily apparent that the specification describes 
what is claimed, namely a registry of business entity definitions that comprises "at least one 
processor." (Claim 21; Appellant's specification, p. 5 line 21 to p. 7 line 13, p. 10 line 28 to 
p. 12 line 33, Figs. 1-6). 

Moreover, the Examiner incorrectly interprets 35 U.S.C. § 112, first paragraph as 
imposing a requirement that the specification explicitly describe all possible embodiments 
of a claim. On this subject the relevant case law is quite clear. The court in Ariad expressly 
stated that "[t]he written description requirement does not demand either examples or an 
actual reduction to practice." Ariad, 598 F.3d at 1352. Additionally, it is long-settled that 
"[a] patent need not teach, and preferably omits, what is well known in the art." Spectra- 
Physics, Inc. V. Coherent, Inc., 827 F.2d 1524, 1536, 3 USPQ2d 1737, 1745 (Fed. Cir. 1987). 
Applying these considerations to the present rejection of claim 21, the Examiner has 
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obviously erred in requiring Appellant's specification to expressly describe embodiments in 
which a registry is implemented by more than one processor. (See Action, p. 2). There can 
be no dispute that it has been long known in the art that multiple processors can and are used 
to perform tasks perfomied by a single processor. Thus, 35 U.S.C. § 1 12, first paragraph 
imposes no requirement that the specification explicitly describe a registry implemented by 
multiple processors for claim 21 to comply with the written description requirement. 
B. Registry comprising Processor 

The Action additionally asserts that Appellant's specification describes only a UDDI 
registry that "may be installed on [a] client/server" and that "[b]ecause the registry is 
installed on the client/server it cannot be the client/server." (Action, pp. 2-3). Following this 
vein, the Examiner concludes that "[b]ecause a registry with a processor is not necessarily 
present in the original disclosure, it is new matter." (Id). Appellant strongly disagrees. 

Appellant's specification describes the UDDI registry as an active component that 
performs certain functionality. (See, e.g., Appellant's specification, p. 10 line 32 to p. 11 line 
13). This functionality cannot be performed by merely software alone, as software is merely 
a set of instructions. Rather, the functions of the UDDI registry must inherently be 
performed by a machine executing software. Thus, the UDDI registry described in 
Appellant's specification inherently has a machine component. Taken in context with this 
fact, the specification's statement that "a UDDI registry may be installed on any such 
client/server" plainly teaches that the described client/server provides the essential hardware 
component to implement UDDI registry functionality. (Appellant's specification, p. 5 lines 
23-24). As such, the specification plainly teaches a UDDI registry that "comprises" a 
processor. 
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C. Registry comprising Computer Readable Memory 
For similar reasons, the Action further asserts that Appellant's specification does not 
describe a registry comprising a computer readable memory. (Action, p. 3; see claim 21). 
Appellant strongly disagrees. 

Again, Appellant's specification describes the UDDI registry as an active component 
that performs certain functionality. {See, e.g.. Appellant's specification, p. 10 line 32 to p. 11 
line 13). This functionality cannot be performed by merely software alone, as software is 
merely a set of instructions. Rather, the functions of the UDDI registry must inherently be 
performed by a machine executing software from a computer-readable memory. Thus, the 
UDDI registry described in Appellant's specification inherently has a machine component. 
Taken in context with this fact, the specification's statement that "a UDDI registry may be 
installed on any such client/server" plainly teaches that the described client/server provides 
the essential hardware components to implement UDDI registry functionality. (Appellant's 
specification, p. 5 lines 23-24). Among the hardware described in the client/server of 
Appellant's specification are "a RAM volatile memory elemenf and a "non-volatile 
memory." (Appellant's specification, p. 5 lines 27-29, Fig. 1; see also p. 12 lines 24-33). As 
such, the specification plainly teaches a UDDI registry that "comprises" a computer readable 
memory. 

D. Conclusion 

For at least the reasons given above, the Examiner has failed to establish that any part 
of claim 21 fails to comply with the written description requirement of 35 U.S.C. § 1 12, first 
paragraph. Consequently, the Final Office Action fails to meet its requisite burden of 
establishing the prima facie unpatentability of claim 2 1 . Therefore, the rejection of claim 2 1 
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and its dependent claims based on the written description requirement of 35 U.S.C. § 1 12, 
first paragraph should be reversed. 

(2) Claims 21-26 comply with the enablement requirement of 35 U.S.C. § 1 12. first 

paragraph. 

Claims 21-26 stand rejected under 35 U.S.C. § 112, first paragraph, as allegedly 
failing to comply with the enablement requirement of 35 U.S.C. § 1 12, first paragraph. For at 
least the following reasons, this rejection is improper and should be reversed. 

A. All Structures for Performing Claimed Functions 

Claim 21 recites a processor that is "configured to" perform various tasks, including 
"receive a request," "obtain the identity of [a] user," "determine . . . whether the user has 
permission," and "deny the user access" to certain information elements. The Examiner 
concludes that because the processor is modified by "purely functional" limitations, "the 
processor is modified by pure functional language with no limitation of structure," and that 
claim 21 is therefore directed to "a// structures for performing the claimed function." 
(Action, pp. 3-4). Because, the Examiner argues, the specification does not disclose all 
possible structures for performing the claimed function, claim 21 does not comply with the 
enablement requirement of 35 U.S.C. § 1 12, second paragraph. (Id) (citing to Ex Parte 
Miyazaki, 89 USPQ2d 1207, 1215-1217 (BPAI 2008)). Appellant strongly disagrees. 

The Examiner's assertion that the fiinctionality performed by the processor recited in 
claim 21 is not tied to any underlying structure is perplexing. Claim 21 explicitly recites that 
a processor, an inherently structural element, performs all of the functionality described in 
claim 21. The processor performs this functionality as exemplified in Appellant's 
specification at, for example, p. 10 line 28 to p. 13 line 7, and Figs. 4-6. Thus, unlike the 
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patent application in the Miyazaki cased cited by the Examiner, claim 21 does not recite any 
"purely functional claim element." {See Miyazaki, 89 USPQ2d at 1215-1217; Action, pp. 3- 
4). 

The teachings of Appellant's specification are sufficient to meet the enablement 
requirement for all of the functionality performed by the processor of claim 2 1 . See N. 
Telecom, Inc. v. Datapoint Corp., 908 F.2d 931, 941 (Fed. Cir. 1990) (computer- 
implemented software is enabled when "a programmer of reasonable skill could write a 
satisfactory program" implementing the functionality). 

B. Importing Structure from the specification 

The Action further asserts that no structure can be imported from the specification to 
remedy what the Examiner perceives as a lack of structural recitations in claim 21. In 
response. Appellant respectfully notes that even if such importation were permissible, which 
it is not, it would not be necessary. The term "processor" is already a structural limitation on 
each element of functionality recited in claim 21. 

C. Purely Software Configuration 

The Action further asserts that "Appellants have enabled only a software 
configuration in their original disclosure." (Action, p. 4) (citing to Appellant's specification, 
p. 12 lines 24-33). Thus, according to the Examiner, because the "claim encompasses a 
hardware configuration for performing the receiving step," claim 2 1 must be rejected for 
failing to meet the enablement requirement. Appellant strongly disagrees. 

Again, Appellant's specification describes the UDDI registry as an active component 
that performs certain functionality. {See, e.g. , Appellant's specification, p. 10 line 32 to p. 11 
line 13). This functionality cannot be performed by merely software alone, as software is 
merely a set of instructions. Rather, the functions of the UDDI registry must inherently be 
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performed by a machine executing software. Thus, the UDDI registry described in 
Appellant's specification necessarily has a machine component. Taken in context with this 
fact, the specification's statement that "a UDDI registry may be installed on any such 
client/server" plainly teaches that the described client/server provides the essential hardware 
component to implement UDDI registry functionality. (Appellant's specification, p. 5 lines 
23-24). As such, the specification plainly enables a hardware configuration for performing 
each element of functionality in claim 21. 

D. Conclusion 

For at least the reasons given above, the Examiner has failed to establish that any part 
of claim 2 1 fails to comply with the enablement requirement of 35 U.S.C. § 1 12, first 
paragraph. Consequently, the Final Office Action fails to meet its requisite burden of 
establishing the prima facie unpatentability of claim 21. Therefore, the rejection of claim 21 
and its dependent claims based on the enablement requirement of 35 U.S.C. § 1 12, first 
paragraph should be reversed. 

(3) Claims 17-30 comply with 35 U.S.C. § 1 12. second paragraph. 

Claims 17-30 stand rejected under 35 U.S.C. § 1 12, second paragraph, as being 
allegedly indefinite. For at least the following reasons, this rejection is improper and should 
be reversed. 

A. "Permission Details" 

Claims 17, 21, and 27 recite different forms of "receiving a request in a processor 

associated with said registry from a user to access a business entity definition comprising a 
plurality of information elements, each of said information elements having permission 
details associated therewith." (Claim 17). According to the Final Office Action, "[o]ne of 
17 
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ordinary skill in the art would not understand what the 'permission details' are associated 
with." (Action, p. 5). In particular, the Action asserts that it is unclear whether "the 
information elements have permission details and the permission details are associated with 
the request" or whether "the permission details are associated with the processor." {Id.). 

Appellant strongly disagrees. Claims 17, 21, and 27 could not be clearer in their 
recitation of "information elements having permission details associated therewith." {E.g., 
claim 17) (emphasis added). The language of these claims plainly indicates that the 
permission details are associated with the recited information elements. Furthermore, the 
independent claims further indicate that the permission details associated with each 
information element indicate whether a given user has permission to access that information 
element. (Claims 17, 21, 27) {e.g., "determining . . . whether the user has permission to 
access that said information element based on the permission details associated with that said 
information element and said identity of the user."). The specification describes the use of 
permission details in this context. {See e.g.. Appellant's specification, p. 3 line 25 to p. 4 line 
16, p. 8 line 6 to p. 9 line 32, p. 10 line 1 to p. 10 line 25, Figs. 4-6). 

The Examiner's ability to reject claims in a pending patent application under 35 

U.S.C. § 1 12, second paragraph is governed by the requirements of the M.P.E.P. According 

to M.P.E.P. §2173.02, 

[t]he essential inquiry pertaining to [the requirement for defmiteness of 35 U.S.C. § 
1 12, second paragraph] is whether the claims set out and circumscribe a particular 
subject matter with a reasonable degree of clarity and particularity. Defmiteness of 
claim language must be analyzed, not in a vacuum, but in light of: 

(A) The content of the particular application disclosure; 

(B) The teachings of the prior art; and 

(C) The claim interpretation that would be given by one possessing the 
ordinary level of skill in the pertinent art at the time the invention was made. 
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Applying this standard, we find that the content of the particular application disclosure and 
the claim interpretation that would be given by one possessing ordinary skill in the art at the 
time of the invention clearly indicate the scope of the term "permission details" recited in 
claims 17, 21, and 27. As such, the Examiner's position concerning the defmiteness of the 
term "permission details" is misplaced and improper. Consequently, the term "permission 
details" is not indefinite under 35 U.S.C. § 1 12, second paragraph. 

B. "Plurality of Information Elements" 

The Action further asserts with respect to claims 17, 21, and 27 that it is unclear 
whether "the request or the business entity definition" comprises the recited "plurality of 
information elements." (Action, p. 5). Appellant again strongly disagrees. 

The specification describes business entity definitions which include a plurality of 
information elements, but does not describe a request that includes a plurality of information 
elements. (See, e.g., Appellant's specification, p. 3 line 14 to p. 4 line 24, p. 8 lines 6-10, p. 9 
line 34 to p. 10 line 1 1, p. 10 line 41 to p. 1 1 line 2, p. 1 1 line 40 to p. 12 line 4, p. 12 lines 
13-18, p. 12 line 40 to p. 13 line 7, Figs. 2-4). Thus, the disclosure of the application 
unquestionably supports the interpretation that the "business entity definition" is the element 
that comprises the "plurality of information elements." (Claim 17). 

Furthermore, the independent claims recite "receiving a request in a processor 
associated with said registry irom a user to access a business entity definition comprising a 
plurality of information elements.'' A reading of this phrase under the conventions of the 
English language results in the clear interpretation that the "business entity definition" is 
what comprises the "plurality of information elements." (Claim 17). Because a person 
having ordinary skill in the art at the time of the invention would read English phrases in a 
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conventional way, such a person would also interpret the phrase as reading that the recited 
"business entity definition" is what comprises "the plurality of information elements." {Id.). 

Again, the M.P.E.P. dictates that a determination of the defmiteness of a claim term 
under 35 U.S.C. § 1 12, second paragraph requires a consideration of 

(A) The content of the particular application disclosure; 

(B) The teachings of the prior art; and 

(C) The claim interpretation that would be given by one possessing the 
ordinary level of skill in the pertinent art at the time the invention was made. 

M.P.E.P. § 2173.02. Under this analysis, it becomes readily apparent that the content of the 

application disclosure and the claim interpretation that would be made by one having 

ordinary skill in the art support a unified, definite interpretation of the independent claims as 

indicating that a business entity definition comprises a plurality of information elements. 

{E.g., claim 17). As such, the Examiner's position conceming the defmiteness of the term 

"permission details" is misplaced and improper. The phrase "receiving a request in a 

processor associated with said registry fi-om a user to access a business entity definition 

comprising a plurality of information elements" is not indefinite under 35 U.S.C. § 1 12, 

second paragraph. 

C. "Business Entity Definition" 

Claims 17-30 also stand rejected as being indefinite under 35 U.S.C. § 1 12, second 
paragraph, because (A) Examiner has not found a lexicographic definition for the phrase 
"business entity definition" and (B) it is the Examiner's position that this phrase is "not 

known to those of ordinary skill in the art " (Action, p. 6). This rejection is utterly improper 
and inappropriate, as the Examiner has not set forth adequate grounds of rejecting these 
claims. 
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With respect to the Examiner's failure to find a lexicographic definition of the term 
"business entity definition" in the specification, the M.P.E.P. is quite clear that "a claim term 
that is not used or defined in the specification is not indefinite if the meaning of the claim 
term is discernible." M.P.E.P. § 2173.02 (citing to Bancorp Svcs., LLC. v. Hartford Life 
Ins. Co., 359 F.3d 1367, 1372, 69 USPQ2d 1996, 1999-2000 (Fed. Cir. 2004)). The 
Examiner's requirement that each claim term be either specifically defined in the 
specification or well-known in the art creates a false dichotomy which precludes the notion 
that a claim's term can be discernible from how it is used in the specification in spite of the 
lack of a formal definition. See id. 

In determining whether a claim term is indefinite under § 1 12, second paragraph, the 
M.P.E.P. requires an examination of the "content of the particular application disclosure." 
M.P.E.P. § 2173.02. The "broadest reasonable interpretation" given to claim terms during 
examination must be "consistent with the specification." Phillips v. AWH Corp., 415 F.3d 
1303, 75 USPQ2d 1321 (Fed. Cir. 2005) (quoting /« re Am. Acad ofSci. Tech. Ctr., 367 F.3d 
1359, 1364, 70 USPQ2d 1827 (Fed. Cir. 2004)); see M.P.E.P. § 21 1 1 (quoting Phillips). 
Therefore, if the specification makes the meaning of a claimed term clear, that term is plainly 
not indefinite under 35 U.S.C. § 1 12, second paragraph. 

The term "business entity definition" is used throughout Appellant's specification as 
an entity in a registry, such as a Universal Description Discoveiy and Integration (UDDI) 
registry, through which a business entity publishes information about the services it provides 
in the form of definitions, each definition including one or more information elements. {See, 
e.g., Appellant's specification, title, p. 2 lines 1-4, p. 3 lines 5-9, p. 4 lines 18-24). The 
specification specifically states the following: 
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The preferred embodiment is discussed in terms of a business entity definition and a 
UDDI registry according to the UDDl specification. The UDDI specification defines 
a set of XML schemas which are templates for creating definitions of business 
entities. As a result a business entity definition may be an instance of one or more 
these [sic] defined XML schemas. 
(M, p. 5 lines 33-37). 

Appellant's Declaration of October 5, 2010 provides multiple documents known in the art 
prior to the filing date of the present application. These documents outline the specifications 
of the known UDDI registry protocol described in the specification. In particular, the UDDI 
specification describes a registry protocol for a businessEntity data structure which "serves as 
the top-level information manager for all of the information about a particular set of 
information related to a business unit. (See, e.g., Appellant's Declaration of Oct. 5, 2010, Ex. 
A p. 6). The elements of the businessEntity data structure are described in detail in these 
documents, and are consistent with what is described in Appellant's specification. (See, e.g., 
id, Ex. B pp. 3-6). 

The specification further makes it clear that in a UDDI embodiment, the "business 
entity definition" comprises "a businessEntity data structure 201 which includes descriptive 
information 202 about the business and information about one or more business services 
which the business entity offers." (Appellant's specification, p. 5 line 42 to p. 6 line 3; see 
also p. 6 lines 28-30, p. 6 line 35 to p. 7 line 15). The specification also states that "while the 
invention has been described in terms of a UDDI registry a skilled person would realise that a 
registry could be implemented, which is not a UDDI registry, but provides a similar fimction 
to a UDDI registry. (Id, p. 12 lines 35-38). 

Accordingly, one having ordinary skill in the art would read the specification as 
teaching that a business entity definition is a definition that includes either a UDDI 
businessEntity data structure or a non-UDDI data structure that performs a similar function to 
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a UDDI businessEntity data structure. Because the composition and use of UDDI 
businessEntity data structures are well-known in the art, one having ordinary skill in the art 
would readily understand the scope of the term "business entity definition" in this context. 
(See generally Appellant's Declaration of Oct. 5, 2010). 

The Action asserts that because only claim 26 is expressly directed to a UDDI 
registry, the knowledge and use of business entity definitions in the context of UDDI 
registries has no bearing on whether the term "business entity definition" is indefinite. 
(Action, pp. 18-19). Appellant strongly disagrees. Again, the specification is clear that the 
term "business entity definition" relates both to definitions which include a UDDI 
businessEntity data structure and to definitions which include a non-UDDI data structure that 
is analogous to the businessEntity data structure. (Appellant's specification, p. 5 lines 33-37, 
p. 5 line 42 to p. 6 line 3, p. 6 lines 28-30, p. 6 line 35 to p. 7 line 15). Thus, knowledge of 
UDDI businessEntity data structures in the relevant art sufficiently renders the more generic 
"business entity definition" term definite in the context of the specification. 

The Action further asserts that "it is not clear [in claims 17, 21, and 27] whether any 
'entity' is part of a registry ('entity in a registry') or if it modifies the business ('business 
entity')." (Action, p. 18). Appellant strongly disagrees. The conventions of the English 
language do not permit reading the term "entity" as modifying the term "registry" in the 
independent claims. For example, claim 17 recites "receiving a request in a processor 
associated with said registry from a user to access a business entity definition comprising a 
plurality of information elements." (Emphasis added). Claims 21 and 27 recite essentially 
this same phrase. No one having ordinary skill in the art would interpret the term "entity" in 
the phrase as modifying the term "registry" instead of the term "business." By asserting 
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otherwise, the Examiner unfairly and unreasonably imposes an invented ambiguity as a basis 
for rejecting the instant claims as indefinite. 

The Action also objects to the Appellant's use of Federal Circuit cases in responding 
to the present rejection. In the Examiner's view, the Board's decision in Ex parte Miyazaki 
renders moot any definiteness standard used for issued patent claims in inter parte 
proceedings because the instant claims have not yet been issued. (Action, p. 17) (citing to Ex 
parte Miyazaki, 89 USPQ2d 1207, 121 1 (BPAI 2008) (precedential). Appellant strongly 
disagrees. The Federal Circuit holdings cited in the present Brief can all be found in the 
M.P.E.P. in sections relevant to the Examiner's rejections made under 35 U.S.C. § 1 12, 
second paragraph. See, e.g., M.P.E.P. §§2111, 2173. Consequently, by adopting these 
standards from inter parte case law in the M.P.E.P., the USPTO has exercised its prerogative 
to include certain inter parte standards from the Federal Circuit in the "lower threshold of 
ambiguity" used by the USPTO personnel during the examination of claims for compliance 
with the definiteness requirement. Miyazaki, 89 USPQ2d at 121 1. 

The Action further cites to Miyazaki for its holding that "if a claim is amenable to two 
or more plausible claim constructions, the USPTO is justified in . . . holding the claim 
unpatentable under 35 U.S.C. § 1 12, second paragraph, as indefinite." (Action, p. 17) (citing 
to id.). Appellant is aware of this holding. Nevertheless, the Examiner has not met this 
threshold, because the Examiner has not been able to demonstrate that the term "business 
entity definition" is amenable to any definition other than what would be logically inferred 
from the claims and specification of the present application in view of the ordinary skill of 
the art. 

For at least the above reasons, the meaning of the term "business entity definition" is 
not indefinite under 35 U.S.C. § 1 12, second paragraph, because this term sets out and 
24 



GB920030007US1 



10/561,260 



circumscribes a particular subject matter with a reasonable degree of clarity and 
particularity." M.P.E.P. § 2173.01. The scope of the subject matter is apparent in light of 
(A) the "content of the particular application disclosure," (B) the "teachings of the prior art," 
and (C) "the claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made," as required by the M.P.E.P. Id. 
Consequently, the rejection of claims 17-30 under 35 U.S.C. § 1 12, second paragraph based 
on the term "business entity definition" should be reversed. 

D. "Registry of Business Entity Definitions" 

The Action further rejects claim 21 as indefinite under 35 U.S.C. § 1 12, second 
paragraph, for the recitation of a "registry of business entity definitions, the registry 
comprising: at least one processor; and a computer readable memory." (Action, p. 6). In this 
regard, the Examiner asserts that one of ordinary skill in the art would recognize a "registry 
of business entity definitions" as an arrangement of data, and that the addition of "physical 
components" renders the term "registry of business entity definitions" entirely 
incomprehensible to those having ordinary skill in the art. Appellant strongly disagrees. 

As described above, the specification describes the UDDI registry as an active 
component that performs certain functionality. {See, e.g., Appellant's specification, p. 10 line 
32 to p. 11 line 13). This functionality cannot be performed by a mere arrangement of data. 
Rather, the functions of the UDDI registry must inherently be performed by a machine 
executing software. Thus, the UDDI registry described in Appellant's specification 
inherently has a machine component. Taken in context with this fact, the scope of the term 
"registry of business entity definitions" would be readily understood by one having ordinary 
skill in the art as including a processor. As such, the specification plainly teaches a UDDI 
registry that "comprises" a processor. 
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Even if arguendo the registry described in the specification did not inherently require 
hardware, a person having ordinary skill in the art of Web Services and registries would 
easily ascertain the scope of claim 21. Persons skilled in the art of Web Services and 
registries would certainly have sufficient intelligence and reasoning capacity to determine 
that the recitation of a registry comprising a processor and a memory would entail a processor 
that manages registry data stored on the memory. 

For at least the above reasons, the meaning of the term "business entity definition" is 
not indefinite under 35 U.S.C. § 1 12, second paragraph, because this term sets out and 
circumscribes a particular subject matter with a reasonable degree of clarity and 
particularity." M.P.E.P. § 2173.01. The scope of the subject matter is apparent in light of 
(A) the "content of the particular application disclosure," (B) the "teachings of the prior art," 
and (C) "the claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made," as required by the M.P.E.P. Id. 

E. "Business Service Entity Information Element," 
Claim 25 (incorrectly identified as claim 26 in the Action) stands further rejected under 35 
U.S.C. § 1 12, second paragraph, because of the Examiner's position that the term "business 
service entity information element," is indefinite. Appellant strongly disagrees. 

Again, the Examiner is inappropriately requiring that these terms be either 
specifically defined in the specification or well-known in the art to comply with § 1 12, 
second paragraph. For at least the reasons given above with respect to the definiteness of the 
term "business service entity," this standard has no legal basis. 

The correct inquiry pertaining to compliance with 35 U.S.C. § 1 12, second paragraph 
is "whether the claims set out and circumscribe a particular subject matter with a reasonable 
degree of clarity and particularity" in light of the "(A) [t]he content of the particular 
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application disclosure; (B) [t]he teachings of the prior art; and (C) [t]he claim interpretation 
that would be given by one possessing the ordinary level of skill in the pertinent art at the 
time the invention was made." M.P.E.P. § 2173.01. No explicit definition of these terms is 
required for the "content of the particular application disclosure" to provide a basis for 
whether the claimed subject matter has "a reasonable degree of clarity and particularity." Id.; 
see Bancorp, 359 F.3d at 1372, 69 USPQ2d 1999-2000 (a claim term this is not defined in 
the specification is not indefinite if the meaning of the claim term is discernible) (quoted in 
M.P.E.P. §2173.01). 

The Examiner has failed to comprehend that claim 25 is directed to a UDDI registry, 
and the terms recited in claim 25 reflect concepts that are well-known in the field of UDDI. 
{See. e.g.. Appellant's Declaration of Oct. 5, 2010, Exs. A-D). For example. Exhibit A of 
Appellant's Declaration describes a "businessService" entity as one of the "core information 
elements that make up the UDDI information model." {Id. at Ex. A, p. 11; see also pp. 5-7). 
Furthermore, Appellant's specification describes the term "business service information 
element" in context, from which one having ordinary skill in the art could easily determine 
the metes and bounds of the subject matter claimed. (Appellant's Specification, p. 6 line 1 1 
to p. 7 line 15, p. 8 line 6 to p. 10 line 22). 

As such, the Examiner has rejected claim 25 while clearly failing to perform the 
necessary inquiry into whether the terms "whether the claims set out and circumscribe a 
particular subject matter with a reasonable degree of clarity and particularity" in light of the 
"(A) [t]he content of the particular application disclosure; (B) [t]he teachings of the prior art; 
and (C) [t]he claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made." M.P.E.P. § 2173.01. As 
demonstrated above, the term "business service information element" is well-defined in the 
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language of the claim, the application disclosure, and the teachings of the prior art. Thus, the 
term "technical model information element" does not render claim 25 indefinite under 35 
U.S.C. § 112, second paragraph. 

F. "Binding Template Information Element" 

Claim 25 (incorrectly identified as claim 26 in the Action) stands further rejected 
under 35 U.S.C. § 1 12, second paragraph, because of the Examiner's position that the term 
"binding template information element," is indefinite. Appellant strongly disagrees. 

Again, the Examiner is inappropriately requiring that these terms be either 
specifically defined in the specification or well-known in the art to comply with § 1 12, 
second paragraph. For at least the reasons given above with respect to the definiteness of the 
term "business service entity," this standard has no legal basis. 

The correct inquiry pertaining to compliance with 35 U.S.C. § 1 12, second paragraph 
is "whether the claims set out and circumscribe a particular subject matter with a reasonable 
degree of clarity and particularity" in light of the "(A) [t]he content of the particular 
application disclosure; (B) [t]he teachings of the prior art; and (C) [t]he claim interpretation 
that would be given by one possessing the ordinary level of skill in the pertinent art at the 
time the invention was made." M.P.E.P. § 2173.01. No explicit definition of these terms is 
required for the "content of the particular application disclosure" to provide a basis for 
whether the claimed subject matter has "a reasonable degree of clarity and particularity." Id. ; 
see Bancorp, 359 F.3d at 1372, 69 USPQ2d 1999-2000 (a claim term this is not defined in 
the specification is not indefinite if the meaning of the claim term is discernible) (quoted in 
M.P.E.P. §2173.01). 

The Examiner has failed to comprehend that claim 25 is directed to a UDDI registry, 
and the terms recited in claim 25 reflect concepts that are well-known in the field of UDDI. 
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(See, e.g., Appellant's Declaration of Oct. 5, 2010, Exs. A-D). For example. Exhibit A of 
Appellant's Declaration describes a "bindingTemplate" entity as one of the "core information 
elements that make up the UDDI information model." (Id. at Ex. A, p. 11; see also pp. 5-7). 
Furthermore, Appellant's specification describes the term "binding template information 
element" in context, from which one having ordinary skill in the art could easily determine 
the metes and bounds of the subject matter claimed. (Appellant's Specification, p. 6 line 1 1 
to p. 7 line 15, p. 8 line 6 to p. 10 line 22). 

As such, the Examiner has rejected claim 25 while clearly failing to perform the 
necessary inquiry into whether the terms "whether the claims set out and circumscribe a 
particular subject matter with a reasonable degree of clarity and particularity" in light of the 
"(A) [t]he content of the particular application disclosure; (B) [t]he teachings of the prior art; 
and (C) [t]he claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made." M.P.E.P. § 2173.01. As 
demonstrated above, the term "binding template information element" is well-defined in the 
language of the claim, the application disclosure, and the teachings of the prior art. Thus, the 
term "technical model information element" does not render claim 25 indefinite under 35 
U.S.C. § 112, second paragraph. 

G. "Technical Model Information Element" 

Claim 25 (incorrectly identified as claim 26 in the Action) stands further rejected 
under 35 U.S.C. § 1 12, second paragraph, because of the Examiner's position that the term 
"technical model information element," is indefinite. Appellant strongly disagrees. 

Again, the Examiner is inappropriately requiring that these terms be either 
specifically defined in the specification or well-known in the art to comply with § 1 12, 
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second paragraph. For at least the reasons given above with respect to the definiteness of the 
term "business service entity," this standard has no legal basis. 

The correct inquiry pertaining to compliance with 35 U.S.C. § 1 12, second paragraph 
is "whether the claims set out and circumscribe a particular subject matter with a reasonable 
degree of clarity and particularity" in light of the "(A) [t]he content of the particular 
application disclosure; (B) [t]he teachings of the prior art; and (C) [t]he claim interpretation 
that would be given by one possessing the ordinary level of skill in the pertinent art at the 
time the invention was made." M.P.E.P. § 2173.01. No explicit definition of these terms is 
required for the "content of the particular application disclosure" to provide a basis for 
whether the claimed subject matter has "a reasonable degree of clarity and particularity." Id. ; 
see Bancorp, 359 F.3d at 1372, 69 USPQ2d 1999-2000 (a claim term this is not defined in 
the specification is not indefinite if the meaning of the claim term is discernible) (quoted in 
M.P.E.P. §2173.01). 

The Examiner has failed to comprehend that claim 25 is directed to a UDDI registry, 
and the terms recited in claim 25 reflect concepts that are well-known in the field of UDDI. 
{See, e.g., Appellant's Declaration of Oct. 5, 2010, Exs. A-D). For example, Exhibit A of 
Appellant's Declaration describes a "tModel" entity which describes a "technical fingerprint 
of a Web Service" entity as one of the "core information elements that make up the UDDI 
information model." {Id. at Ex. A, pp. 7, 11). Furthermore, Appellant's specification equates 
the term "technical model" functionally with the UDDI tModel entity, and describes the 
entity in a way that one having ordinary skill in the art could easily determine the metes and 
bounds of the subject matter claimed. (Appellant's Specification, p. 6 line 1 1 to p. 7 line 15, 
p. 8 line 6 to p. 10 line 22). 
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As such, the Examiner has rejected claim 25 while clearly failing to perform the 
necessary inquiry into whether the terms "whether the claims set out and circumscribe a 
particular subject matter with a reasonable degree of clarity and particularity" in light of the 
"(A) [t]he content of the particular application disclosure; (B) [t]he teachings of the prior art; 
and (C) [t]he claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made." M.P.E.P. § 2173.01. As 
demonstrated above, the term "technical model information element" is well-defined in the 
language of the claim, the application disclosure, and the teachings of the prior art. Thus, the 
term "technical model information element" does not render claim 25 indefinite under 35 
U.S.C. § 112, second paragraph. 

H. "Business Entity Information Element" 
Claim 25 (incorrectly identified as claim 26 in the Action) stands further rejected under 35 
U.S.C. § 1 12, second paragraph, because of the Examiner's position that the term "business 
service entity information element," is indefinite. Appellant strongly disagrees. 

Again, the Examiner is inappropriately requiring that these terms be either 
specifically defined in the specification or well-known in the art to comply with § 1 12, 
second paragraph. For at least the reasons given above with respect to the definiteness of the 
term "business service entity," this standard has no legal basis. 

The correct inquiry pertaining to compliance with 35 U.S.C. § 1 12, second paragraph 
is "whether the claims set out and circumscribe a particular subject matter with a reasonable 
degree of clarity and particularity" in light of the "(A) [t]he content of the particular 
application disclosure; (B) [t]he teachings of the prior art; and (C) [t]he claim interpretation 
that would be given by one possessing the ordinary level of skill in the pertinent art at the 
time the invention was made." M.P.E.P. § 2173.01. No explicit definition of these terms is 
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required for the "content of the particular application disclosure" to provide a basis for 
whether the claimed subject matter has "a reasonable degree of clarity and particularity." Id.; 
see Bancorp, 359 F.3d at 1372, 69 USPQ2d 1999-2000 (a claim term this is not defined in 
the specification is not indefinite if the meaning of the claim term is discernible) (quoted in 
M.P.E.P. §2173.01). 

The Examiner has failed to comprehend that claim 25 is directed to a UDDI registry, 
and the terms recited in claim 25 reflect concepts that are well-known in the field of UDDI. 
{See, e.g.. Appellant's Declaration of Oct. 5, 2010, Exs. A-D). For example. Exhibit A of 
Appellant's Declaration describes a "businessEntity" entity as one of the "core information 
elements that make up the UDDI information model." {Id. at Ex. A, p. 11; see also pp. 5-7). 
Furthermore, Appellant's specification describes the term "business entity information 
element" in context, from which one having ordinary skill in the art could easily determine 
the metes and bounds of the subject matter claimed. (Appellant's Specification, p. 6 line 1 1 
to p. 7 line 15, p. 8 line 6 to p. 10 line 22). 

As such, the Examiner has rejected claim 25 while clearly failing to perform the 
necessary inquiry into whether the terms "whether the claims set out and circumscribe a 
particular subject matter with a reasonable degree of clarity and particularity" in light of the 
"(A) [t]he content of the particular application disclosure; (B) [t]he teachings of the prior art; 
and (C) [t]he claim interpretation that would be given by one possessing the ordinary level of 
skill in the pertinent art at the time the invention was made." M.P.E.P. § 2173.01. As 
demonstrated above, the term "technical model information element" is well-defined in the 
language of the claim, the application disclosure, and the teachings of the prior art. Thus, the 
term "technical model information element" does not render claim 25 indefinite under 35 
U.S.C. § 112, second paragraph. 
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I. Conclusion 

For at least the above reasons, the Action has not met the Office's burden to establish 
the prima facie failure to comply with 35 U.S.C. § 1 12, second paragraph, of any of claims 
17-30. Therefore, the rejection of claims 17-30 on these grounds is improper and should be 

reversed. 



(4) Claims 17. 21. and 27 are patentable over Kramer. 

Claims 17, 21, and 27 stand rejected under 35 U.S.C. § 102(b) as being allegedly 
anticipated by Kramer. For at least the following reasons, this rejection is improper and 
should be reversed. 



Claim 17: 
Claim 17 recites: 

A method for a registry of business entity definitions to handle user requests to 
access business entity definitions, the method comprising: 

receiving a request in a processor associated with said registry from a user to 
access a business entity definition comprising a plurality of information elements, 
each of said information elements having permission details associated therewith; 

obtaining the identity of the user from data associated with the request with 
said processor; 

determining with said processor, each of said information elements, 
whether the user has permission to access that said information element based on 
the permission details associated with that said information element and said 
identity of the user; and 

with said processor, deuyin;^ the user access to those information elements 
for which it is determined that the user does not have permission. 
(Emphasis added). 

Appellant notes that "[t]he examiner bears the initial burden . . . of presenting a prima 
facie case of unpatentability." In re Oetiker, 977 F.2d 1443, 1445, 24 USPQ2d 1443, 1444 
(Fed. Cir. 1992). In a rejection made under § 102, this burden is substantial, as a prima facie 
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case of anticipation requires a demonstration that "eac/z and every element as set forth in the 
claim is found, either expressly or inherently described, in a single prior art reference." 
Verdegaal Bros. v. Union Oil Co. of California, 814 F.2d 628, 631, 2 U.S.P.Q.2d 1051, 1053 
(Fed. Cir. 1987) (emphasis added); see M.P.E.P. § 2131. 

The Federal Circuit has further clarified that "unless a reference discloses within the 
four comers of the document not only all of the limitations claimed but also all of the 
limitations arranged or combined in the same way as recited in the claim, it cannot be said to 
prove prior invention of the thing claimed and, thus, cannot anticipate under 35 U.S.C. § 
102." NetMoneyIN, Inc. v. Verisign, Inc., 545 F.3d 1359, 1371, 88 U.S.P.Q.2d 1751, 1759 
(Fed. Cir. 2008) (emphasis added). 

In light of these considerations, the recent Office Action does not meet the requisite 
burden to establish the prima facie anticipation of claim 17. Specifically, the Examiner has 
failed to demonstrate that the Kramer reference teaches or suggests each and every element 
recited in claim 17. See Verdegaal, 814 F.2d at 631, 2 USPQ2d at 1053. 

Kramer is directed to "a data processing system [that] includes a plurality of data 
objects which are accessible by application programs through a system level interface." 
(Kramer, col. 1 lines 56-59). According to Kramer, "[e]ach data object has an associated user 
access lisf and "at least one key indicating which applications can access that object." {Id., 
lines 59-62). "Both the application identifier key and the user who invoked that application 
must match the identifier information in the data object for access to be allowed to that 
object." {Id., lines 64-67). 

The Action cites to teachings in Kramer about a user attempting to access such a data 
object, asserting that the data object of Kramer reads on the "business entity definition" 
recited in claim 17. (Action, pp. 9-10) (citing to Kramer, col. 3 lines 50-51). Appellant 
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respectfully disagrees. In construing a claim, the meaning of words used in the claims is 
determined by the plain meaning of the words in light of the meaning given to those words in 
the specification. Markman v. Westview Instruments, 116 U.S. 1384, 38 USPQ2d 1461 
(1996); McGill, Inc. v. John Zink Co., 736 F.2d 666, 674 (Fed. Cir. 1984); ZMI Corp. v. 
Cardiac Resuscitator Corp., 884F.2d 1576, 1580, 6USPQ2d 1557, 1560-61 (Fed. Cir. 1988) 
("words must be used in the same way in both the claims and the specification"). 

The plain meaning of the term "business entity definition" implies that data structure 
that defines a specific business-related entity. Additionally, the specification uses the term 
"business entity definition" to refer to an organization of data that "provides details of 
services provided ... by a business" and "descriptive information . . . of the business." 
(Appellant's specification, p. 5 line 40 to p. 6 line 9). Thus, from the plain language of the 
term "business entity definition" and the fact that the specification only uses this term to refer 
to data defining a specific business entity, to anticipate the term "business entity definition" 
the data object of Kramer must at least be associated with and define a business entity. 
Kramer does not teach or suggest anywhere that each of its data objects is associated with a 
business entity. Accordingly, the data object of Kramer does not read on the "business entity 
definition" recited in claim 17, and Kramer does not teach or suggest "receiving a request 
from a user to access a business entity definition." (Claim 17). 

As evidence that Kramer teaches the plurality of information elements recited in 
claim 17, the Action cites to Kramer's teaching that "[w]hen access is requested of a 
particular data object . . . through the system level interface, the system level interface 
compares the identifier of the original invoking user and the calling data managers with those 
stored in the access list 36 and key list 38. (Action, p. 10) (citing to Kramer, col. 4 lines 66- 
68). According to the Examiner, the "identifier of the original invoking user and the calling 
35 



GB920030007US1 



10/561,260 



data managers" read on the "information elements" of the business entity definition in claim 
17. This position is logically indefensible. Kramer is clear that "[w]hen a user invokes a data 
manager application, either directly or indirectly, a user identifier is contained within the 
process identifier of a process associated with such invocation," and that "when a data 
manager makes a call to the system level interface the identity of the calling data manager is 
made available to the system level interface as well." (Kramer, col. 3 lines 20-34). As such, 
Kramer leaves no doubt that the identifiers of the user and the calling data managers are not a 
part of the data object that is being accessed. While Appellant expressly states that Kramer 
does not teach or suggest a business entity definition, even if arguendo Kramer did teach a 
business entity definition, the Examiner has still failed to demonstrate any teaching in 
Kramer of a business entity definition "comprising a plurality of information elements." 
(Claim 17). Indeed, Kramer does not teach or suggest such "a business entity definition 
comprising a plurality of information elements" anywhere. (Id). 

Additionally, by asserting that the identifier of the user and the identifier of the 
calling data managers read on the "information elements having permission details associated 
therewith" recited in claim 17, the Action puts itself in a logically untenable position. The 
problem with this position stems from the fact that claim 17 recites "determining ... for each 
of said information elements, whether the user has permission to access that said information 
element based on the permission details associated with that said information element." 
(Claim 17). 

The Action further asserts that the access control data stored for a data object reads on 

the permission details recited in claim 17. Thus, under the Examiner's interpretation of 
Kramer, if a user wishes to access a data object, permissions associated with the data object 
will be compared to an identifier of the user and an identifier of a calling manager to 
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determine whether the user may access his or her own identifier and the identifier of the 
calling manager. Kramer plainly does not teach such a system. Even if it did, such a system 
would not read on that of claim 17. 

Finally, Kramer does not teach or suggest "denying the user access to those 
information elements for which it is determined that the user does not have permission." 
(Claim 17). Again, claim 17 is explicit that a business entity definition includes multiple 
information elements and that a user is denied access on an individual basis to those 
information elements for which the user does not have permission. In this regard, the Action 
cites to Kramer's teaching of using access control lists to grant or deny a user access to a data 
object based on the user's identity and the identity of a calling manager. (Action, p. 10) 
(citing to Fig. 4). However, in asserting that this subject matter in Kramer reads on claim 17, 
the Examiner forgets his previous assertion that the identifier of the user and the identifier of 
the calling manager read on the information elements of claim 17. Yet, Kramer does not 
teach or suggest any type of controlled access to these identifiers. Rather, Kramer only 
teaches controlled access to a stored singular data object. Accordingly, the Action has not 
demonstrated that Kramer teaches or suggests "denying the user access to those information 
elements for which it is determined that the user does not have permission." (Claim 17). 

Again, "[a] claim is anticipated [under 35 U.S.C. § 102] only iieach and every 
element as set forth in the claim is found, either expressly or inherently described, in a single 
prior art reference." Verdegaal, 814 F.2d at 631, 2 U.S.P.Q.2d at 1053; see Verisign, 545 
F.3d at 1371, 88 U.S.P.Q.2d at 1759; M.P.E.P. § 2131. Thus, Kramer cannot anticipate claim 
17 because, for the above reasons, Ki-amer fails to teach or suggest all of the subject matter 
present in claim 17. Because the Office has not met its burden to demonstrate the prima facie 
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unpatentability of claim 17, the rejection of claim 17 and its dependent claims based on 
Kramer should be reversed. 



Claim 21 recites: 

A registry of business entity definitions, the registry comprising: 
at least one processor; and 

a computer readable memory communicatively coupled to said processor 
having said business entity definitions stored thereon; 
wherein said processor is configured to: 

receive a request from a user to access a business entity definition 
comprising a plurality of information elements, each of said information elements 
having permission details associated therewith ; 

obtain the identity of the user from data associated with the request; 

determine, for each of said information elements, whether the user 
has permission to access that said information element based on the permission 
details associated with that said information element and said identity of the user, 
and 

deny the user access to those information elements for which it is 
determined that the user does not have permission. 

(Emphasis added). 

Kramer also fails to anticipate the registry of business entity definitions of claim 21 
because Kramer does not teach or suggest all of the subject matter recited in claim 21. 
Specifically, as amply demonstrated above with respect to independent claim 17, Kramer 
does not teach or suggest "receiv[ing] a request fi-om a user to access a business entity 
definition comprising a plurality of information elements, each of said information elements 
having permission details associated therewith," "determin[ing], for each of said information 
elements, whether the user has permission to access that said infomiation element based on 
the permission details associated with that said information element and said identity of the 
user;" or "deny[ing] the user access to those information elements for which it is determined 
that the user does not have permission." (Claim 21). 
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Again, "[a] claim is anticipated [under 35 U.S.C. § 102] only if each and every 
element as set forth in the claim is found, either expressly or inherently described, in a single 
prior art reference." Verdegaal, 814 F.2d at 631, 2 U.S.P.Q.2d at 1053; see Verisign, 545 
F.3d at 1371, 88 U.S.P.Q.2d at 1759; M.P.E.P. § 2131. Thus, Kramer cannot anticipate claim 
21 because, for the above reasons, Kramer fails to teach or suggest all of the subject matter 
present in claim 21. Because the Office has not met its burden to demonstrate the prima facie 
unpatentability of claim 21, the rejection of claim 21 and its dependent claims based on 
Kramer should be reconsidered and withdrawn. 



Claim 27: 
Claim 27 recites: 

A computer program product for a registry of business entity definitions to 
handle user requests to access business entity definitions, the computer program 
product comprising: 

a computer readable storage medium having computer usable program code 
embodied thereon, the computer usable program code comprising: 

computer usable program code configured to receive a request from a 
user to access a business entity definition comprising a plurality of information 
elements, each of said information elements having permission details associated 
therewith; 

computer usable program code configured to obtain the identity of the 
user from data associated with the request; 

computer usable program code configured to determine, for each of 
said information elements, whether the user has permission to access that said 
information element based on the permission details associated with that said 
information element and said identity of the user ; and 

computer usable program code configured to deny the user access to 
those information elements for which it is determined that the user does not have 
permission. 
(Emphasis added). 

Kramer also fails to anticipate the computer program product of claim 27 because 
Kramer does not teach or suggest all of the subject matter recited in claim 27. Specifically, 
as amply demonstrated above with respect to independent claim 17, Kramer does not teach or 
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suggest "receiv[ing] a request from a user to access a business entity definition comprising a 
plurality of information elements, each of said information elements having permission 
details associated therewith," "determin[ing], for each of said information elements, whether 
the user has permission to access that said information element based on the permission 
details associated with that said information element and said identity of the user;" or 
"deny[ing] the user access to those information elements for which it is determined that the 
user does not have permission." (Claim 27). 

Again, "[a] claim is anticipated [under 35 U.S.C. § 102] only if each and every 
element as set forth in the claim is found, either expressly or inherently described, in a single 
prior art reference." Verdegaal, 814 F.2d at 631, 2 U.S.P.Q.2d at 1053; see Verisign, 545 
F.3d at 1371, 88 U.S.P.Q.2d at 1759; M.P.E.P. § 2131. Thus, Kramer cannot anticipate claim 
27 because, for the above reasons, Kramer fails to teach or suggest all of the subject matter 
present in claim 27. Because the Office has not met its burden to demonstrate the prima facie 
unpatentability of claim 27, the rejection of claim 27 and its dependent claims based on 
Kramer should be reconsidered and withdrawn. 

(5) Claims 19-20. 23-24. and 29-30 are patentable over Kramer in view of Stefik. 

Claims 19-20, 23-24, and 29-30 stand rejected under 35 U.S.C. § 103(a) as being 

allegedly obvious over Kramer in view of Stefik. This rejection is improper and should be 
reversed at least for the same reasons given above in favor of the patentability of independent 
claims 17, 21, and 27. See In re Fine, 837 F.2d 1071, 1076, 5 USPQ2d 1596 (Fed. Cir. 1988) 
(if an independent claim is nonobvious, then any claim depending therefrom is nonobvious); 
M.P.E.P. §2143.03. 
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(6) Claims 18. 22. 25-26. and 28 are patentable over Kramer in view of Solomon. 

Claims 18, 22, 25-26, and 28 stand rejected under 35 U.S.C. § 103(a) as being 
allegedly obvious over Kramer in view of Solomon. This rejection is improper and should be 
reversed at least for the same reasons given above in favor of the patentability of independent 
claims 17, 21, and 27. See Fine, 837 F.2d at 1076 (if an independent claim is nonobvious, 
then any claim depending therefrom is nonobvious); M.P.E.P. § 2143.03. 



(7) Claims 17.21. and 27 are patentable over Kramer in view of Stefik. 

Claims 17, 21, and 27 stand rejected under 35 U.S.C. § 103(a) as being allegedly 
obvious over Kramer in view of Stefik. For at least the following reasons, this rejection is 
improper and should be reversed. 

Claim 17 recites: 

A method for a registry of business entity definitions to handle user requests to 
access business entity definitions, the method comprising: 

receiving a request in a processor associated with said registry from a user to 
access a business entity definition comprising a plurality of information elements, 
each of said information elements having permission details associated therewith; 

obtaining the identity of the user from data associated with the request with 
said processor; 

determining with said processor, each of said information elements, 
whether the user has permission to access that said information element based on 
the permission details associated with that said information element and said 
identity of the user; and 

with said processor, denying the user access to those information elements 
for which it is determined that the user does not have permission. 
(Emphasis added). 



Claim 21 recites: 
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A registry of business entity definitions, the registry comprising: 
at least one processor; and 

a computer readable memory communicatively coupled to said processor 
having said business entity definitions stored thereon; 
wherein said processor is configured to: 

receive a request from a user to access a business entity definition 
comprising a plurality of information elements, each of said information elements 
having permission details associated therewith ; 

obtain the identity of the user from data associated with the request; 

determine, for each of said information elements, whether the user 
has permission to access that said information element based on the permission 
details associated with that said information element and said identity of the user, 
and 

deny the user access to those information elements for which it is 
determined that the user does not have permission. 
(Emphasis added). 



Claim 27 recites: 

A computer program product for a registry of business entity definitions to 
handle user requests to access business entity definitions, the computer program 
product comprising: 

a computer readable storage medium having computer usable program code 
embodied thereon, the computer usable program code comprising: 

computer usable program code configured to receive a request from a 
user to access a business entity definition comprising a plurality of information 
elements, each of said information elements having permission details associated 
therewith; 

computer usable program code configured to obtain the identity of the 
user from data associated with the request; 

computer usable program code configured to determine, for each of 
said information elements, whether the user has permission to access that said 
information element based on the permission details associated with that said 
information element and said identity of the user; and 

computer usable program code configured to deny the user access to 
those information elements for which it is determined that the user does not have 
permission. 
(Emphasis added). 

In rejecting claims 17, 21, and 27 under these altemate grounds, the Examiner 
maintains the assertion that Kramer teaches "receiving a request . . . from a user to access a 
business entity definition comprising a plurality of information elements, each of said 
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information elements having permission details associated therewith" and "determining . . . 
for each of said information elements, whether the user has permission to access that said 
information element based on the permission details associated with that said information 
element and said identity of the user;" and "denying the user access to those information 
elements for which it is determined that the user does not have permission" for the same 
reasons used by the Examiner to reject these claims under § 102(b). (Action, pp. 13-14) 
(quoting claim 17). Appellant strongly disagrees with these assertions for the same reasons 
given above with respect to the § 102(b) rejection of claims 17, 21, and 27, noting that the 
Examiner has utterly failed to establish that Kramer teaches or suggests any of this subject 
matter. 

Stefik does not remedy the deficiencies of Kramer in this regard. Specifically, Stefik 
utterly fails to teach or suggest at least the subject matter of "receiving a request . . . from a 
user to access a business entity definition comprising a plurality of information elements, 
each of said information elements having permission details associated therewith" and 
"determining ... for each of said information elements, whether the user has permission to 
access that said information element based on the permission details associated with that said 
information element and said identity of the user." (See claims 17, 21, and 27). Notably, the 
Action only relies on Stefik for the teaching of a processor. (Action, p. 14). 

According to the Supreme Court, the factual inquiries set forth in Graham v. John 

Deere Co., 383 U.S. 1, 17-18 (1966), "continue to define the inquiry that controls" 

obviousness rejections under 35 U.S.C. § 103. KSR Int'l v. Telejlex Inc., 550 U.S. 398, 407 

(2007). Under the analysis required by Graham to support a rejection under 35 U.S.C. § 103, 

the scope and content of the prior art are to be determined; differences between the 
prior art and the claims at issue are to be ascertained; and the level of ordinary skill in 
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the pertinent art resolved. Against this background, the obviousness or 
nonobviousness of the subject matter is determined. 
Graham, 3S3 U.S. at 17-18. 

While these inquiries are factual, the ultimate determination of obviousness is a conclusion of 
law made in view of the totality of the resolved Graham factors. KSR, 550 U.S. at 427; 
Graham, 383 U.S. at 17. 

Applying the Graham analysis to the present rejection of claims 17, 21, and 27, the 
scope and content of the prior art, as evidenced by Kramer and Stefik, does not include all of 
the claimed subject matter, including at least "receiving a request . . . from a user to access a 
business entity definition comprising a plurality of information elements, each of said 
information elements having permission details associated therewith" and "determining . . . 
for each of said information elements, whether the user has permission to access that said 
information element based on the permission details associated with that said information 
element and said identity of the user." (See claims 17, 21, and 27). 

The differences between the cited prior art and claims 17, 21, and 27 are significant 
because the claimed subject matter provides features and advantages not known or available 
in the cited prior art. Therefore, no combination of the cited prior art references would 
feasibly produce the subject matter recited in claims 17, 21, and 27. As such, no one having 
ordinary skill in the art at the time of the invention would have been able to combine the 
Kramer and Stefik references to arrive at the claimed subject matter as a whole. 

This fact is significant because under the rationale chosen by the Examiner to reject 
claims 17, 21, and 27, a prima facie case of obviousness requires a factual demonstration that 
"the prior art included each element claimed, although not necessarily in a single prior art 
reference, with the only difference between the claimed invention and the prior art being 
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the lack of actual combination of the elements in a single prior art reference." M.P.E.P. 
§ 2143(A) (emphasis added). 

Consequently, the cited prior art will not support a rejection of claims 17, 21, and 27 
under 35 U.S.C. § 103 and Graham, and the Office has not met its requisite burden to 
establish the prima facie obviousness of claims 17, 21, and 27. For at least these reasons, the 
rejection of claims 17, 21, and 27 should be reversed/reconsidered and withdrawn. 

In view of the foregoing, it is submitted that the final rejection of the pending claims 
is improper and should not be sustained. Therefore, a reversal of the Rejection of August 4, 
2010 is respectfully requested. 



Steven L. Nichols, Esq. 

Van Cott, Bagley, CornwaU & McCarthy 

36 South State Street 
Suite 1900 

Salt Lake City, Utah 84111 

(801)237-0251 (phone) 
(801)237-0871 (fax) 



Respectfully submitted, 



DATE: December 2, 2010 




Steven L. Nichols 
Registration No. 40,326 
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VIII. CLAIMS APPENDIX 

1-16. (canceled) 

17. (previously presented) A method for a registry of business entity definitions 
to handle user requests to access business entity definitions, the method comprising: 

receiving a request in a processor associated with said registry from a user to access a 
business entity definition comprising a plurality of information elements, each of said 
information elements having permission details associated therewith; 

obtaining the identity of the user from data associated with the request with said 
processor; 

determining with said processor, for each of said information elements, whether the 
user has permission to access that said information element based on the permission details 
associated with that said information element and said identity of the user; and 

with said processor, denying the user access to those information elements for which 
it is determined that the user does not have permission. 

1 8. (previously presented) The method of claim 17 wherein the request specifies 

a search criteria, and wherein the method further comprises: 

determining with said processor what information in the business entity definition the 
user wishes to access using the search criteria to locate the business entity definition; and 

determining with said processor whether the user has permission to access the 
information that the user wishes to access. 
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1 9. (previously presented) The method of claim 1 7, wherein determining with 
said processor whether the user has permission to access information in the business entity 
definition from permission details associated with the business entity definition and the 

identity of the user comprises determining with said processor whether a user has permission 
to access an information element from an access policy and permission details associated 
with a different information element. 

20. (previously presented) The method of claim 19 wherein the information 
elements are in a hierarchy and wherein determining with said processor whether the user has 
permission to access information in the business entity definition fi-om permission details 
associated with the business entity definition and the identity of the user comprises 
determining with said processor that a user does not have permission to access a first 
information element if permission details associated with one or more second information 
elements directly beneath the first information element in the hierarchy indicate that user 
does not have access to one or more of the second information elements. 

2 1 . (previously presented) A registry of business entity definitions, the registry 
comprising: 

at least one processor; and 

a computer readable memory communicatively coupled to said processor having said 
business entity definitions stored thereon; 

wherein said processor is configured to: 
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receive a request from a user to access a business entity definition comprising 
a plurality of information elements, each of said information elements having permission 
details associated therewith; 

obtain the identity of the user from data associated with the request; 

determine, for each of said information elements, whether the user has 
permission to access that said information element based on the permission details associated 
with that said information element and said identity of the user; and 

deny the user access to those information elements for which it is determined 
that the user does not have permission. 

22. (previously presented) The registry of claim 21 wherein the request specifies 
a search criteria, and wherein the data processing host device is further configured to: 

determine what information in the business entity definition the user wishes to access 
using the search criteria to locate the business entity definition. 

23. (previously presented) The registry of claim 21, wherein the the data 
processing host device is further configured to determine whether a user has permission to 
access an information element from an access policy and permission details associated with a 
different information element. 

24. (previously presented) The registry of claim 23 wherein the information 
elements are in a hierarchy and the access policy specifies that a user does not have 
permission to access a first information element if permission details associated with one or 
more second information elements directly beneath the first information element in the 
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hierarchy indicate that user does not have access to one or more of the second information 
elements. 

2 5 . (previously presented) The registry of claim 2 1 , wherein the data processing 
host device is further configured to: 

locate the permission details in a file system in which the permission details are in a 
location in the file system which is defined according to the information element with which 
they are associated. 

26. (previously presented) The registry of claim 21, wherein the registry is a 
UDDI registry and the information in the business entity definition is a business entity 
information element, the business entity information element containing one or more 
business service entity information elements, each business service entity containing one or 
more binding template information elements and each binding template containing one or 
more references each referring to a technical model information element. 

27. (previously presented) A computer program product for a registry of business 
entity definitions to handle user requests to access business entity definitions, the computer 

program product comprising: 

a computer readable storage medium having computer usable program code embodied 
thereon, the computer usable program code comprising: 

computer usable program code configured to receive a request from a user to 
access a business entity definition comprising a plurality of information elements, each of 
said information elements having permission details associated therewith; 
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computer usable program code configured to obtain the identity of the user 
from data associated with the request; 

computer usable program code configured to determine, for each of said 
information elements, whether the user has permission to access that said information 
element based on the permission details associated with that said information element and 
said identity of the user; and 

computer usable program code configured to deny the user access to those 
information elements for which it is determined that the user does not have permission. 

28. (previously presented) The computer program product of claim 27 wherein 
the request specifies a search criteria, and further comprising: 

computer usable program code configured to determine what information in the 
business entity definition the user wishes to access using the search criteria to locate the 
business entity definition; and 

computer usable program code configured to determine whether the user has 
permission to access the information that the user wishes to access. 

29. (previously presented) The computer program product of claim 27, wherein 

the computer usable program code configured to determine whether the user has permission 
to access information in the business entity definition Irom permission details associated with 
the business entity definition and the identity of the user comprises computer usable program 
code configured to determine whether a user has permission to access an information element 
from an access policy and permission details associated with a different information element. 
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30. (previously presented) The computer program product of claim 30 wherein 
the information elements are in a hierarchy and wherein determining whether the user has 
permission to access information in the business entity definition fi-om permission details 
associated with the business entity definition and the identity of the user comprises 
determining that a user does not have permission to access a first information element if 
permission details associated with one or more second information elements directly beneath 
the first information element in the hierarchy indicate that user does not have access to one or 
more of the second information elements. 
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IX. Evidence Appendix 
The following pages include a copy of a Declaration filed by Appellant on Oct. 5, 2010, 
including Exhibits, the Declaration being referenced in section Vn of the present Appeal 
Brief 
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IN THE UNITED STATES PATENT AND TRADEMARK OFFICE 



In the Patent Application of 

John Colgrave 

Application No. 10/561,260 

Filed: October 16, 2006 

For: User Access to a Registry of Business 
Entity Definitions 



Group Art Unit: 3621 
Examiner: Joshua A. Murdough 
Confirmation No.: 5696 



DECLARATION UNDER 37 C.F.R. S 1.132 

Mail Stop Appeal Brief - Patents 
Commissioner for Patents 
P.O. Box 1450 
Alexandria, VA 22313-1450 

Sir: 

I declare the following: 

1 . I am an attorney of record in the prosecution of the instant application, U.S. 
Patent Application Serial No. 10/561,260. 
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2. Attached to the present declaration as Exhibit A is a document entitled "UDDI 
Technical White Paper," which is a known documentation of the UDDI standard. This 
document was published as early as September 6, 2000, and is presently available on the Internet 
at http://uddi.org/pubs/Iru_UDDI_Technical_White_Paper.pdf. 

3. Attached to the present declaration as Exhibit B is a document entitled "Modeling 
the UDDI Schema with UML," which describes a known XML Schema associated with the 
UDDI Specification. This document was published as early as February, 2001, and is presently 
available on the Internet at 

http://www.xmlmodeling.com/models/uddi/article/ModelingUDDI.pdf 

4. Attached to the present declaration as Exhibit C is a document entitled "UDDI 
Programmer's API 1 .0," which is a known documentation of the UDDI standard. This document 

was published as early as June 28, 2002, and is presently available on the Internet at 
http://uddi.org/pubs/ProgrammersAPI-V 1.01 -Published-20020628 .pdf 

5. Attached to the present declaration as Exhibit D is a document entitled "UDDI 
Version 2.03 Data Structure Reference," which is a known documentation of the UDDI standard. 
This document was published as early as July 19, 2002, and is presently available on the 
Internet at http://uddi.org/pubs/DataStructure_v2.pdf 
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6. Each of Exhibits A-D was publicly available at the time the present application 

was filed. 

7. Exhibit A describes a data structure known as a "businessEntity element," of 
"businessEntity," which "serves as the top-level information manager for all of the information 
about a particular set of information related to a business unit." (Exhibit A, p. 5). Exhibits B-D 
also refer to the businessEntity element, provide additional descriptions, uses, and specifications 
for the data structure. (See, e.g.. Exhibit B, pp. 3-5; Exhibit C, pp. 12-14, 17, Exhibit D, pp. 5-6, 
8-14). 

8. These disclosures demonstrate that the terms "businessEntity," "businessEntity 
element," and their equivalents had accepted and understood meanings in the relevant art at the 
time the present patent application was filed. 
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9. I hereby declare that all statements made herein of my own knowledge are true 
and that all statements made on information and belief are believed to be true; and further that 
these statements were made with the knowledge that willful false statements and the like so 
made are punishable by fine or imprisonment, or both, under Section 1001 of Title 18 of the 
United States Code and that such willful false statements may jeopardize the validity of the 
application or any patent issued thereon. 




Octobers. 2010 
Date 



Steven L. Nichols 
Attorney for Applicant 
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UDDi regislnes are Lised to promote and ci^cov e-- 1: d:suibvik;d Web seivices. TNs paper 
dsscribeV the capabiiiGes that these registnes add: io ii-is Wg;;g Vv'ide Web, 
The tntended aiidience is the anyone looking ior a corceptija} ovesview of UDDi for the purpose of 
understanding what it is, t^^io uses it. and how a diStribuied rsgistry n iakes ;t possible for your programs 
to discover and interact vwth Web setvices ihat otiier companies expose on the Wisb 
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introduction 



Overview 

Tn-. I litvo^St^i Des.;npt'cr Discovery and Imegrahon (UDDI) specsfscatiors df^fine a vvrt\' to pur^ij^h and 
d&covar jniom-iatson aSxJUt Web aesvices. The term 'Web service" describes sisecffc sxismess 
fundionalify exposed by a compsny, usually through an internet connscfion. for the purpose of 
providing a way for another company or software program to use the seri^iee. 

Web services are beccjmingthe programmafic backbone for etectronic commerce. Foe example, one 
osmDany calls another's service to send a purchase order dimctly vsa an internet connecfeon Mothet 
exanide ts a ^er^ice that c^oiiates ttie cost of shipping a package of a certath size or weight, so many 
mifes via 8 specific earner. 

At first giance, rt would seem ^mpie to manage the process of Web setVice a^ccAeryy After o' :^ 
icnnwn bustn^s^ p?>rtne has a Knovw eiectronic commerce cateway whs* te*{ io disoovt > ; 'n*- t^at 
essijr^t>lion how^ff n h5t9iio*th«>i!tfomigfion(»'5! Of? ^ i- ' \ -51 war to tinci eUVitci 

bus.nes«i Ma i( ^ >^ ticf se-vtces U-'oal'^'i^ unU j n niedf^icut 

Oiie O">t(or 1- 3ii o pinner on the phone j; ^ <> < < w.oni> slf' aIi f^oi s 

business tirft xpnstng Web services, having to stalt u c j ifjSv ornrfip-op! f icjiiixv 
random cstscowery demand is drfficuit to justity, 

An^jt-^sr w?^ to solve this probfer« ss through an approach th<at u<?p>s 9 '^'e^. ^en^ice^ oesc .iptic^n fi's on 
esc icori'spanvs Web Site Ak a' ' &'-'t<^r'iwor\b/sn2i.'>->\]f,r!=<\X'^t^ii^R\ctr6BQiik^^to 
dfSCO^orsndind-iKtcxt'Ov n m < tM c--!pproxh hovA vu 

deperdsntonthc atiii V f>.t c ^ ' t kxatiD tof 'ht rvtv uip^on 

file on that Web stte Tms d st-^^xScu oj > x', i> potenttafty scalable out tacks a r.echenisn to 
eoDSistency in service aescriptio^ iofj^nats and for tne easy tmd^ng of changes as &>ey oocut. 
UOOt lakes an approach that rete mon a diStnout«5d reg'stry bustnfessfes and thesr sarvice 
desjaiptie^s implernented ipa comittoi) XMLTotmat 

Tf-L core corr ponot-rt of the tjDDt prafect is the UDDI business nsgistration. an XML file used to 
d-^sctibe a bi^siress en^ty and Hs Web sen/tees, Conceptuaity, the information provided in a UOO! 
business rsgist'^tion consists of three components ^Mte pages' including address, contact and 
wviai identifiers "Veilow pages" i ick'd nq 'txk otna! categonzatons based on standard taxoncyntes, 
and "green pages" the tecl itn - =5i (nfor-^at' - j-- ^tc ^t -^nn, tees tiiat am exposed by file business Green 
pages tndude references to spi. ulcatic is tot vVeb sen^ices, as ^neW as support for pointers to va^us 
file and URL based discovery mechanisms ff required. 

UDD! nJu -its l-^s sh-' 'ed > 'pciation of a business registry on the Web For the most pBit pnsgrams 
an i n Qi aiT'^nof'? . tie UDDi Business Ri^istfy to locate infoimatiW about services and, m the 
r^se of progi ai n -^ei 3 '0 pH pare systems thai are con^ipatibte wth advertised Web sen/Ices or to 
des(.Jibfe tneit own Web services for omofs to call fix, t^DDi Bus^ne*^cl Rr-g s,tt y can 6v yer at a 
business levei to ched< wl-iethei a g.vei-» pamer has pat'^ui^r \\»b sc rvc. » tprf3'-'^s> to ind 
companies a given industry' mth a given type of setv re and xo tocat* information ohDJt hov-- 0 
partner or ntenoed nartner has exposed a Web service n order lo lesxr the ttxhntc^i details requ r.-d 
to interact win mat service, 

Afte- rcoc t u , p^per the reader wift have a dearer understanding of the capabittttes defned n ti^e 
t iCDi =--36 'fi-^aiions and have a clearer understanding of &ie roie of Web sendee registnes ih<)' 
implement these specaficattons. 
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Tb<i number of ways that cornpanses are using the Worid Wide Web vasifss considerably Many 
comp.3:i!«s are starting to detine ways to a!iov>' their internal applications to tnte!-a.:s the busiriess 
sy sien";3 at oV^et companies using the emercpng Web ifTf{r<©taicti.He. Lef{ alone, each company inv^nt^ 
& unique approach based on the expetiences designens, avaiiabletecfmologies, anci project 
budgets. The prcrfiferation of integration approac*ies and unique solutions have spawned an sDtfre 
sub-industry focused on bridging incompatibte service layers witJiin and across company boundaries. 

Recent work within the W3C starts to raise hopes that Exterisibte Matl<up Lariguage {XfvSi..,> w?ii play a 
role in sifrif^ifying the exchange of bsjsiness date between companies. Further, collaboraijori bet^veen 
computer industry giants and small comparties aiike have outlined a framework oafied SOAP that 
allows one program to invoke service interfaces across the Iriternet, wittiout fhe need to share a 
common programming iangtfage or distributed ol^ect tnfrastnicture. ,Aji of th!s is good ne-A^ tor 
compsntes feeiing the cost pressures associated with efedrontc commaroi because the fouifjoations 
for common interoperabiftty standards are being iatd. Because of these founciatlcn Ssohnoiogias and 
ems-rejino stanoards, some of the intradable problans of the past are becoming easier to approach 

From XUl ana SOAP or^e can oliservethat the integration and fnteropefab!!%- problem has been 
simplified in iayer?.. K¥.L provides a coss-pSa-foiTn aDDroaos-' to data encodinu and formatting SO*^, 
■Mvch iir- buiif o':; ^K.U., df-finss" a sn^pie way to r-"-;' -i^'f iorexci-iange across system 

bot.moanes SO.AP i^inuuiys ior hn"rF are t)'.i.Si I .i^- ..r^--- iQ;ny protocoi and dafme a way to make 
^e^^^a{s ptoc.e<,!i.it5: caSls between systems in a mannej ihat i.5 independent ofth& programming 
iangiisge or operafirig system choices made by ifidividual Gompariies, Prior approaches irr/olved 
com!:^sx distributed object standards or techndogy bridging software. NeKher of these appnsacf-iss has 
proven to bs cost effective in the long run. Using XML and SOAP, this cross-language, cfoss-piatfonm 
approacii sin^piiifes the probi-'jm of making systems att^Afi companies compatible w^th each othei". 
Even when onv. .-ro; ifsiders XK5L j'nd 3C-AP, 'iy^.y^ !'-::r^: nre st^i^ vast gaps ihfouoi> vv^iich any tsvo 
companies can fall in impiem.entng a cxwrnunications infrastnioture As any industry pundit vwli teii 
you. Vv'hat is required is a fuB end-to-end sciution, based on ^ndards that sm unb/ersa!!y supported 
on every comp^jting platfonrt," Qearty. Siere is more work to do to achi^e this goal. The UDDi 
specificafions borrow the lesson learned frwi WL and SOAP to define a next-laysr-up that lets two 
companies share a xiway to query eadt over's capabilities and to dsscribe Sieir ovm capabtftttes. 

Ttie foltovwng diagrain depicts this layered view; 
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Figi^ 1 



U&Sil - the technical discovery tayer 

The Unlve?T:35 Oescripfton, DiSCO^.'efy and Integration (UODi) specication descnl>e.s a conceptual doud 
of Web sen/ices and a programfrsa^c interfacelhat define a simple framewvotit for deschbing any kind of 
Web sen^ice. The spedfication consists of several rdated documents and an XML schema that 
defines a SOAP-based programming protocof for registering and discovering Web sen/ices. These 
soedrtcatiofis wars defined over a serte-s of months by tedinidans and managers from several leading 
companies. Together, these companies have undertaken the ta^ of building the first implementauon 
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of the UDO! services and mnning these services as a publicly accsssibis. multi-site partnership tiist 
shares ai! registered infonnation. 

The fd!o\Mng diagram shows the reiationshtp bet«i<e6n the spsdfications, the scfiema and the 
tJCOl business registry cioud that provides "register once, pitbiisbed everywhere" access to ^formation 
about Web seivices. 



!3!id schema am used to 
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discovery bf se?v1c8s. 

Figure2 

Using St0 tJODt discovery ser^^ices. businesses indivlduatly register Infortnation about the Web services 
that tfiey expose for use by other businesses. This infcsmation can be added to the UDDi business 
registry either via a Web sits or by using tools ttiaf ma!<e use of ths programmaSc sea-ice interfaces 
described in the UDD! Proprsmmer's APi SpedficaSon. The UDi^i business registry h a iogicaiiy 
i^^ntrafeed, physically distributeci sswtce vvith mulnpie rooi nodes that replicate dsts with esch other on 
a regular basis. Once a business fegistsrs with a angle instance of the business registry service, the 
data is aiJtomsticatiy shared with other UDDl root nodes and becomes freeiy available to anyone v^o 
needs to discoveriMiat Web services are exposed by a given txjsiness. 

As me (ayers in SgiufB t mm, it is impctrtant to note te UDDi does not fomfj a liiii-featured discovery 
^rvice. tJDO! seamless are targeted at enafc^ing tet^rsca! discovery of services. With tiie facilities 
defined by UDD!, a program or programmer cart locate Informatior* aboi.it service.-? exposed by a 
partner, can find whether a partner has a service that is ccsnpatible with in-house tedmotogies. sn^i c^r. 
fdlow iinks to the specifications for a Web sen/ice SO tJ)at an integration iaver can l:te constajcted th-ai 
wii! tie compatible witii a Dahners servtce. Businesses can also locate poleniie}! p3rir:srs Ihrougii UDDl 
directJy, or more iiKeiy. frcn onSine marketplaces and search engines that use UDO! as a da\a sos-ffce 
for their own vaiue-added sen' tces Technicai compatibfifty can be discovered so that software 
companies can use the UDDl registries on the Web to automatic^iiy configure certain teciiriicsi 
Gonnedicsns as software is tnstaiied or accounts are sonfigured. 

Biist»ess discovery and USDi 

UDD! is designed tc f.o--nplement existing online ir-grKstoiaces and ssarci-\ engiries by providing them 
vwth standardizeci foi-mats for programrnatic bjfe!n«,'»s and service discovery. The abiffty to locate 
parties that csr> prov! je a specific srodijct or se'\'CB at a gi\'en pnce or vwthin a specific geographic 
boundary in a g;\en ttn^etVame ts not d reefy ccx'(?re.i i>y !■!•» !J0[): specificalSons. These kinds of 
advanced discover/ %-ati;re? requ re fuft.-isr coifiboraton and design work between buyer and sellers. 
Instead, UDD! forms the basis for deftning these servtces in a i^igher iayer> 
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Advsrcsd Discovsry via Portafe & Msfketpiecss 




Figure 3 

in hgute 3 we can {he reiaiicinstiip bet^sen the tedmicaf disotwety iayers defined by UDDJ snd 
{he roie of aggregation and sperctaiszed soarol: copsl-sisfissthai address business tevei seafxiies, 
Currantiy, rri<-5rke!piaCfiS and s.earcn portaih, U-u; ■■■ned. and caft be integrated or popuJated using 
information pubsished in tne UDD! dtsmduted registries. 

FMt«re work 

The Seams wooing on t^.e UDD! are pi?ir.nir;g o'i exfercJ ;^ ihe fi.T-imaitty beyond whai is In the Open 
Draft specification to address more than lust techriscai discoverv. Puiure feaujres will address the ability 
to !ix:<3te products ;-<nd services defmo V-'e;; .^i- ,-\..c ,!rr-.- :T-;:;Uri rc-^i.-witinns and nrfwde ihe ability 
to manage hiersrchiaai business organi^aiions, ctx-vnunit-e^ and '/af ,5r,--up;5 1 in.; dtivmg goal is to 
provide a puisiic specificaiton fcs- Web ser\'ice interoperaotiw. vs-i ''smer the forujs i-~ rTiarketrface-to- 
mari<8tp!sce or buslness-to-business. 

The remainder pf this paper is s technicr.if ovr.;ryio\v r.'f tos v.:no;j? ieatures of tl le UDDi discovsfy 
sea/ice snd specifications. 



leennteai overview 



The Univcrsai lJesc--!ption, Dsscwer^/ and Integration (UDDi) spectffcalions conast of sn XML si:h8rna 
for SOAP aiessages, and a description of the UDDi AP! ^c^fcatton. Together, t>ese form a base 
information mode! and interadion ffamework that provides tiie abSty to pubB^ itT^txmation about a 

broad an-ay of Web serv'fces. 

Four information types 

")"iie CDf5i inforrTjation modfji usee; by ti^e UDD! r^gisti^es i;- ■>-t>f;ri ■•i ar- XML ?c'nsm3, XML was 
chosen because 15 offers 3 piat^cnrt-neutrai View of dat'.i -:!-■ ,.. .\ : • r.-cn-cai rei^alo^^,hi}:■GtoD^•• 
d^;3cr•hed in a natural way. The errierg;'-^g KML sci-ierv-.; ;>!.;■! ■• v : v. c -oien hecai^r-e of its support 
for ficb data ^y■pes .^s v^-ei! as its ability to eaaiy descnde ar j vs-iaale i-;',.-nn8tion b<3sed on inforn-gtion 
models represented sn sichemas. 

Tho UDDf Xi^lL -sciiefna defines tour core types of infomuitioti ti-iiii ppovide the kinds of tnfomiaticn that 
a t=>chnica! person would iieed to know in order to use a partners Web services. TSiese are: business 
iftfomiatjon; service information, tsndng irtformaSort; and information about ^diicaflonsfor setvices. 
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F{gure4 



The mfcsmiation htsrarchy and t»s key XML eisment nganes that are ussd to descnbe and discover 
information about Wsb services am ^Ofwn irs ftgure 4'. 

B«ssoess tnfom%3tloi!i: the lmsf«essEnt8ty element 

Vauy f^'tn::'-'^ vvi n^eatofx v^'-^k- > 'c niatto'^ ^! v< h o m " lil havL as stsnng 

Key 'dsrt fiers as v\<eli as opt3<>nat (. ateyon,.<.t on and contea infomianon 1 ne core XML sSen^ents ''or 
suppoiling piJtsJtshtng and discovenng infoRTjafeon sboot a business - the UDDf Bu^ness f^egistratton - 
- are contained tn a structure named "businessEnti^"*, "Diss sfrudure setvss asihe top-levei 
nformaifon manayerfor a'i of the irtfowation ^\jq\.i{ ^ partteuls' set of informatton re(atod to a business 
unit". 

can U8 pr-rrameo to locate busnesseb vvs o oorysu «j }J<3 »' ut^' !ri.'Ui.{ -y > rpiodurt categorv', oj v-tiO 
are located mthm b spetafic geogfaphse re^oo. 

Service lt^orm»tionrtf^busitfess$^ce and NndlngTempI^ 

Te-cnnicas and i^tu*;trie'^? < iest^t iptio-s of Wtsb se'v'ces the "greett p^es* slata - \m iA,ithin sub- 
stfucturss of the buo nc5.i>b'^ti'v if ^ormafioii Two jjtaidures are oeflnec! bustnessSe'Vice ^'■d 
bm6>nQlm-\p s'? T be i?u-^ nessRr vjk ^ <5tr' Jdt ino a de«; iptives container that ts used to group a 
series of related Web ^.ervices telau a to eitre- » L^i! ^sss j'ocoss or category of services Bcampies 
of business processes tbat wotJd ^ciude reiote- A t > v k e 'nformation sndude purchasing sefvices, 
sbfppsng services, and oimr high-ieve! btistness processes. 

1 tee busJnessServioe infonrtatton sets can each be further categorized allowing Web service 
descnptfons to be segmented along combinatfORS of mdus^. product and service or geogrspbfc 

C8tegor\' oourtdartes. 

W!*hit "(51 h bih neSbS&t^^ics li\ l c^e or rnore lecmicat Web ser^ m desc-^pnons Theo^t CK-nU :m 
iMoT^^i on tbcit iS f e!e vcttt toi appfi&stion p'tsgtams th£)t nejod to cnf irstx, to yi'^-d tbei t sommt > ncdte with 
'orn-^ir vYcL ser^^ice This information indudes the address to ivjake cotect wtti a Web servicst, as 



See app>sr(ct(x A to s mofe tttsmpisie wew cft>es;UDOi srformstitsft mosJst. 
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wei! as support for option information that can be used to desaibe both hosted services* and seivices 
that require addi^onal values to be discovered fffiorto invoking a setvjce^, AddKion^ features are 
defined ^st alfow for compJex routing options such as load baiandng', 

SpeclflGatioft |»ointers ma technical n»0ei|>r$nts 

The Infofmation required to actually invoice a s^ice is desciibed in the trrfotmation element named 
i3!ndingTempl^> Tttis was de^ijed in the previous secSon. Hovsieven It isnot^waysenough to 
simply know w^iere to contact a particular Web service. For instance, if J know that a business partner 
has a Web service that lets me send them a pijrchase order, knowing tlie URL for that sen/ice is not 
very U'jefu! unless I kr^owf a.e^^* d-al about wj-idt frsfj-nrsf ti:s puchase ofiC'r hh->J i >o '■eri wiiat 
p' otocois are appropnate v^tiot secuf itv required, and what fonrt of a re^n^e rob' I't ? ic sending 
the p jrvhd'ie -^rd^r i-itf^qiating all parts of two systems that tnteract vsa Web services ca i i>econ"e 
quite cOT>piex, 

As a p og'arr y progi-c-nmer snte'-ested tn specific Web fcervices infcsmaton about conoattbiiib/ a th a 
oven '^of-'C'Icgt^O'-' !•? rpquf^x! tn make "^ure that the nqht V*'pb '^mc& ts invoked for a parte jiar need 
>-0' this re<35>oi ^^ir Ut oing I cn^pMto eicmeit vOnl«-'ins a ^i-HXiO oienit, that u c libt of leferences to 
mform^tirm at(\it «p*>nfioation<^ Used as an opaque'' set of tden'tfieiP these refersrces fcnn a 
techniral fingcpnnt that can he used to recognse a Weo fesrvtt^ that ijrtpSemi^nts ? parttctaar behavior 
or programming fnterfaee. 

in ou"- nurct)ase order example the Web service that aooepts the punshase order exhibits a set of vw^fi- 
d£fine<' b-h iV!cr= t th? ta^ x> -document *omiat i<? ^setit to the proper address m the nght way A UDDf 
regist at on o fi s<.i\n t \,wQjrt < c r / -^nP -^or the business partner, a logtcai service enfry th^ 
descrbes tt J .atnxj i,eivK e anr' a binoij tgl cr^olats entry ihisX desicribes ttie purefvase order 
service by i'sttng is URL and a re%ence to a tMooei 

These referencses are adtuafiy^e keys that can be used to access ir^tarmation atrout a ^rfca^on. 
Called "tMoiiels" this infDnmK-tJon is mefsdafa assout a s?)eaficaton indudtng itr name oubtshng 
organizsfton a^dURL p^fT-ers oT" actoal speciftcaiio-isthens'^Kc.a in n sr o^^T-pi' thetMcie' 
fC5fDr8ncetou"ldint^..v.<!^Jil t^lt,-iitiiait o ok ^ f* !f>i 'ton b-iui'hc m '\> =5se 

orde"" Web se^'lce 1 "tv, 'e^e'ori- o isse'i is <■! pleo^e ty *t c ton pj w J 'Oi ^ <i >o ■> i * " > -^f^v ce tiat 
hfc!^' h.?vp impaTientec' a seivtce that is compat!bi& \«th tModei that is reterencea n tnts vva-^' 
maiiv/ companies ban provide Web servsces that are oomfjaStrfe vs^th tiie^ime speafjcafions, 

The UODt speofications indude defirafemsfor Web sen/ice tnt^sces that allow progianrrtal : acre-js 
to the UDDi regtstty information The fuil de*iniion srf thgs fyogramniers API is fuund m the 
Ptiogr^mer'sAPi Speaticatfon document. The API caf^btiitfes are bnefiy discussed below. 

The Apt is (gvfded into two iogica! parts These are the inquiry AP! and the Pubiishers' APf. The 
inquiry API is further divisfble into two parts - one part used for constructing programs that let you 
search arid brswse Infom^tion found fn a UODi r^istry. and another part that (s useful in the event that 
Web senctce invocaftons expeiienee J^ilures, ProgrammetB can use the Publishets APi to create nch 



* Offter cof«f>8Ri8s orowsiw hosted s«rvses- swjfeaiiY on a fee t)«(S«. KftarketpSaees m aoofS exampfess <rf hoste«l ser vtses. 
Kncwtf?8 8 servse sa eompaifbse v»«t! Shst speeifcsuoo. 

" Hats AkideisdorofaetuaU 'csfil^Jif t^eso^>J*!^pe^,|f(oa*^0^^ ODDs <is'itie<! a tismtsiAwit ?c« ai^jnq ^d*. -sn aqc o. JK 1 
iocaee based on svhe^ssr o? not Ificy contaio reTer ersces to specific spec^caaon fe-sys . 

and VeriSign. -m. All Riqhts Re=;e>^>il. 



interfaces for tools tiiat interm dfsdJy with a UDDJ r^istry, le^ng a technicaJ person manage Ui© 
infomiation pubifshed about eftber 3 businessEnSity or a tModei sMJdure. 

The SffTiL^e Objed Access Protocoi {SOAP) is a W3C ciryi^. n.oi.e desc"ck;g 3 way to use XML snd 
HTTP to create 3n infomiation deiivery and remote procedure n^echanls^-iS. Several ccsmpanies, 
induciing IBM, Microsoft, OevetopMenfor and Useriand Sc-rfl'A'are, syb;-r,ined this dr.gft note to the W3C 
for -he purpose of, ai-nong other things, standardising RPC (simfrfo rrsosiseging} cotwentions on the 
Wi:s-!d W:de: vVetx ir? its; c-iisrent s!a*e, the rfr=5ft note de&cn&es a speciftcation that is useful for 
describing a Web serv^ics. The cornpanieu^ li^at coitebofsied on UOOi decided to base the UDD! APfs 
on this SOAP specification. The ^ecifics of how SOAP and XML are used by UDOi f^s^v Operstors 
are defined in tie appendices in Itis AP! specif idstion itself. 

A!l of the APf ealfs cfeffrtod by me UDDf Proorammer'e APi Specificiattod behave synchronousiy - and 
aiE 0? the distributed UDDS registry Operator SSfes sufspoft aS of the csdls described in tie Programmer's 
AP! Specification, 

The !ft<}«i»y API 

The inquiry APi consisSts of tw types of calls that iet a program quickly locate candidate businesses. 
Web sf.vices arid specif^cofcons, et^d then dtiii Into spedfics based on oven^iew information provided in 
initial calls. The Apis nanted fit^jtx. pwide the eallerwiti a brcrad overview Of registration data based 
on a vanetv of search criiena. .^JtemMeiy, if the acttiai keys of specific data are f<nQvvn ahead time, 
up to date copies of a psrticuisr structure {e,g. bus)n85sEn%, bosinessService, bindingTempfate^ 
tModei'; can be rstneved in fuii via a dired csit. These direct caSs ere caiied the geL^x AFts. 

TIte ysDI sfivocatfen model 

E3c!^ in(!iv..;!i -.mi :jcivet1ised Wsb sen/ice is modeled tn a bifxiincjTeniplats structure. Invocatior; of g 
Weo Tsyivn-.!;; i^. ivps<aiiy penormed based on cadieei bindingTempiate data. Wittn tbis sn mind, thg 
ger!-.:i;:i! sc'iu.:r!o fc;r usng UODI becomes dear vrf)en you consider the preparation required to write a 
prograni that uses a specif c Web sen/ice. The fdiowing recipe outtines these steps 

1 , The prGgratTirncr, chsttered k; wite a proc?ran" t,^a{ use-; a r eniote Web seryice. uses U^e UDDi 
{>USiness registp/ {either via a Web interfaci";; or ot; -er toe; that uses the inquiry APS) to kicate the 
bijsiriessEntity information registered by or for the appropriate: busiiness pail^ner that is ;.:dverijs.ing 
the Web seiv!c« 

2, Ti"is progrenimer aither d.nlls i5oat! for more detat! about s buslnessServiaj or recjuests a fuli 
businessEntity stnjdure. Since businessEnttty structures contain ail infonnation about aiiv^ertised 
Web seivices, the programme seletSs a particuiar bindingTempiate*'' arxj saves this away for iater 
use. 

3, The programrtier prepares the program based on the knowledge of the specif cations for the eb 
service. TNs fnforma^on way be obtained by using the Mxlel key information contained in the 
bindingtemplate fey a service, 

4, ,^t njntime, ttie program invokes the Web serwce as planned using ttte cashed bindingTemplate 
information (as appropriate). 

!n the general c.a3e. assuming ttie remote Web service and the (ailing program each accurately 
impiement the required interface convengons (as defined in the spedflcstion referenced tn the tWodei 
information), the cafis to the remote service function succes^lly. The special case of failures and 
recovery is ou8ined next. 



l.i ST'ti fit«J„»i !fwu«>' APt, a UDO! coin^atilse bro*sef ma dispiay more or <ietaS as someore s«a:chfsj iiyaigr- 
infoitrtatScT!. Ones the afjpropriate if^fofnwSon fe focsJecS. ihs gs*„xx caSi fetums ftjfl irsformatitsfi about cine cS ihe four k«!v t'Dtj; 

S i.-, f^T E m B ft e . 2000 '■'^G ^ " 

six: ViBsiSigri, inc. At! Rights Reserved. 



l^e««v«iV £Hter remote Web service csli failure 



0ns of the kfsy benefits of rnaintiaintng snformation iabout Web services in a distributed UDDI RsgiiMry is 
the seif service" capabtiity provideti to techfiicg: pe'^ontie!. The recipe in the previous section oijtltned 
the tasks that the programmer is a&ie to accompissh using the infotmafion found in the UDD! registrv'. 
This IS Bl\ Sne gnd we!!, but additiona! tenefits are passifaie. These benefits of using a distnbuied UDD! 
re^stry with irrformatiQri hosted at C^mtmSi^&m manffested in disaster r^ovesy scenarios, 

Web services businesses using Web services to do comtfleree with their pertners f^eed to be able to 
detect and manage conimunicatitMi proiDtems or other falures, A key concern is the inabitiiy to predict, 
detect, or recover from faiiures wfSlin the systems of the remote partner. Ev^ sirrspie situations such 
as teniporar^/ outages caused by nightly maintenance or bad(-«ps can maks the dedsion to rysjgrate to 
Web services difficult. 

Orj the other hsnd> if you are tie ccBYipany lhat makes direct Web service connecSons ppssibte. 
disaster recovery and the abiftty to migrate alf of your business partners to a i3ac!<-up system are prime 
concerns. 

UDD! starts to address tiiese "qu^ity of sen/ice" Issues by defining a caiiing amvenijon that involves 
using cached binding Tamptate irrfcsroatiori, and vahen failures occur, refreshing the cached infarmafion 
wim current infomia^on from a UDD! Web regisfty. The recipe for this convention goes iike this; 

1 : Prepare pragram fefWeb service, caching the required bindingTemfdate data for use at 
run-tims. 

2. When caliing the remote Web service, use the cached ^ndingTm^piate data {!-»at v*®s 
obtained from s UDCS Web registry. 

3. if the cai! fails, use I'ns biridtnqKey vah.ie and th*5 ^el i^indingTemptate AP! cae to get a 
fi-esh copy of a bindingTemplate for this unique V\<eb sefvico. 

4. Compare the new infoanatton wth the old ~ if it Is different, retry the failed call. If the retry : 
succeeds, repiace tSie cached data with the new data. 

Behind the scenes, when a bu-vrxiss nieos u> 'ed're-rt rra'tV, ;o a r^e^A tocat-ori 0( b^ickup system, -hey 
oniy tieed to activate the tiacKup system and then change the published iocation information for tiie 
effected bindingTwjpiates. This approadi is caiiad refjy an faOm - and is more efficient than gei«n§ a 
fresh copy tsncSngTempiate dafe prior to eadi eatt, 

TIte PiifaJicaSion API 

The P'Jblicat'on APi consists of four sav'e_xx funcSOfJS and four deiate. .xx functions^ one e;-ch fertile 
foLir key UDDi data strjctures {busnesstintity. bosinessSen/ice, bindingTemplate, i^lcdeh. Once 
authoh^sd. an mdivldu.gl part^' can fegf&tcrany numtx'r of bus>ines,sSntity or tf^^lodei infoirriation ;:Sts. 
and can aitef irjrortriation previotisiy published. The .AP! design rnodei is s^rnpia - changes to specific 
related infomiation can be made and ne* information be saved using save. Complete staicture 
deletion >s accorrjrnodattxi by the deiete celis. See the Programmer's APi Specifiiation for more 
information on this topic, 

S-ecuHty; ldem% and SiMthorlsEstiort 

"t ne key operating prindpai for the UDDI Pub'is-'-eis' APi is to oiily allow aiiThorized individuats to 
pubiisli or change information wihn tt-ie UDDi !M;'=;:n5:;» • egistc,', each of the tndwidual 
impiementaffons of tie dislriixjted UOD\ h .,-=;:ness rec-ii';. '-a '\{^\ -^i a unique ii.'it of auithorized patties 
and tt^cks vwhich businessEnlity or vMrjoei dais vvas crefiitb a pcVtiCilar individuai. Changes and 
deietions are only allowed if a change request {via APt cal!} is made by the same individual wlio 
created t!ia effected infosmafion. 



Cop\'!jH; 2''i-.>->-'AC^ bv ^.".f '.f:)!,tr«, Asisa, tnc., Co!;>!<wce One. iix.. Pusisu Limited, Hwifta-Pscksnj Compsfiy. (2 Techiioiogiss. 'frr., 
N Co^),^U tt-i^M. .h3i'-uswasM<3f(-fr'GSLort>o'5!iOfi fiifrosoftCor{.0'«t)Ot> OiaCtt-Co'porwtto-i, SAP A<3 IV«ff rnsystcms tnc 



Each instance of a UDDI business registry, catied an Operator S/fe, is allowed to ctefine its own end 
user autheoticafion mechanism", but ati oT the contracted UDD! Operator Skes are required to meet 

certain rntr!fms.jm cntena that prcfvide simfigr seciffiJy pfotections. 



Other infonnation 



For r-iore d'jti^iis on she liDDi scf-erna or the UODI Programmer's AFf Specificafe. consult the 

cioiXirvier^ta ihst are 3vaiSc?c!ie or- {i'-e uddt.org Web site. 

These sp^^ci^!C3Uon3 are pudishexi as a set of Jinked }-fTML docur ients, wf-h specffic tModeis defined 
foi- relaf-?d sub setvice offerings. ?"he (txiividuai tiVlodei references ere actueiiy overk/iew infofmation 
with snared iinks to overview. APi caii, and appendix information within the overall speciftcatioj'i. 

Prirttabie versions of the ftjirt spedftcestion in Miaosoft Word and PDF format will aiso be avaiiabis for 
downioad. 



' ' Fiiv^sie imptemefstaSofis thai afe rwitf using the UODi speeiitcaStsfia caf not be forcedi to impiement arsy spsoffic conventions w 
■ <5r;i.;tre:T>f:n(s. !-or miss resKW, foe sure ic stmiit »>e ODO! imptesnwler if yon rsawe Ci(ies!kioa abcuJt aeouffty or inkviiivstir r; 
a-Kfiss c.»iir>:a ptsiictsss. 
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Apitendix A: UDDi information model 
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This section conlstns the ioeations of various specificaferss, document references and usef 
infotmation where you can team mons about this subji^. 

• W3C XML. and reteted reccsinmendaSsns: htto:/jwww.vtf3.org/TR 
« SOAP 1 . 1 W3C note; hltp://wvw.v^.oran-R/#Notes 

«: UDD! Web site; MQl^J!^^^^^^M4{:<,^<i 

G UDDt Progrcsmrrisr s APi Spedfscatior?: 

http://w.vw.utidi.ofq»'pubSf'UpDi Prot^rammers APi Spedfication.pdf 

o UDDI DataStnjdufe Refgj-ence; 

http://mw.uddi.cifq/pubs/UDDi XML Structum R^i^ncei,»df 

o UODI Revision 1 .0 sdisma: http://www:udcli.ofp/sGhema/uddi t.xsd 
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Modeling the UDDI Schema with UML 

Exhibit B 



CiwpkxXM s- cibiUnd inn tuts a'-t. ott<.n i l^ i i u oU s v> iun 

a? e expressed )^fvm,i'h ^hhou^ii vKHtsn^ ti. k u „ n ht, . ( u <. stit^ -i rhii 
regard(ea * Mcnmbtiits Wl^ ^uth tuh ) *hi,v i^^Uvt UK hnxud o a strict in.iaah)^ UiuvoUh*, 
vocabulaiN jstiuctus^. \f wU»pt(,\ str'jctun ^ ise oiit n u pas^nlci in sthcnns us ns^ ^ t emit) *f ion >>t 
contajnmcnt ana link icfejcncts (mtludmg JD IDRFF, Mm,i!e hrei .utnbi tes and more fle\ioi^ 
extciukd XI ink aUnbutes) Ihese mojc objcct-ouented models oi schema defimuon -sre muie ea<.ih 
tprv'^^;^ted u^sng \ 'M! t^lass diagrams [1 j 

( ncnti.d ' Jbb! and du^ ui p il iv. uu<,s tJu 5itcv'-s,.t\ \ ^ n \ i t n <.<.ici 
ia-^gi .ue SlI Ml ha-i e\pet icnced lapia growth and adop>ion the la-si t\\o ^tiars duv, i \ ^■?<3rt ib 
Nv,nJ )t u dcpt,ndttH spec sfjcat ton as a standard by ihe Object Management Oroup (OMO), fhis. L Ml 
andaid <.m \ mt,t< nodci arc the basis tor a new wa\e ot modeling tools hv mm\ vendors Ih^i t tore 
tit fit'- ui ! i i n c« es<. ^ pscs c sIk \\ ch po**i' it \ f dtltjiL c m ch Ut^s vie^ '•d 
hid )irf s c m i .! r I UHi i u 1 m u i tsr th t s^aoiff^^' ma I Ml t^.hni kvi s 

0\ ii h-is iKo aJ vd a ^t« d nUk-^chahj^c ioin'^< ,oi stmu/fijii n'odtis and c^vh liiLii 4 ihcm 
bcn^ c^n KM tools cal'td the \ Ml Metadata Imerthange (XMI) s'XXitVauoii [2] {WU is actuail; 
broddtr m suop^ han this but its iise wnh \ 'KtL most prevaiem j Vlan> I ML modclitij, 00b nw 
up port export tisinu the XM I'ormM, sott ? ov\ possthje So get ain XMI dot-umeni thdt contaft^s 
} nij k t I M! n-'di, dvhiiiio' i tis t„ip>btliu is dx foundation foi the remiaind<;r of this 
M xi f „ an XMI iik ccp^itUu ttoi s jns lAII 100!, 1 have ■v^^^te^l an \$! Ttian<itorn^atf{m that 
gei e dies an \M I St. hema do<. u r;,ni mm the I \!I cla$^> modd oetlnstion 

\s dn cxasup e thai d^n oi-^tjaies iht btiuhls of mudehng XMf xot^ibidanes v\ ,in \ Ml \ h<i\i, '•(;,\<,rsc- 
<? -iginecicd 1 substantial pait of the UDDI specification Pj The current \ JDD1 spetificalion (a> of 
janu£jj\ 2001 ) includes an XMI Schema defiiiifion that is based m m old version of the XMI Schema 
dmit. well before ifie out-dated April 7* 2000 draft. In eonirast. the UDDI scheinas described here are 
co'iipiamwjtitheXMt Schema Candidate Recommendation dated October 24 2000 Fhe revesse 
engineering was accomplished itianiiallv bv reading the I DPI specification and creatmg a I ML mode! 
ni Rational Rose, 

ilii*, js vsork in piogiess' \ spent onh i k^^ t s \ ^ die IJDDI specification tnd schema while 
b lildsng thts n^odcl 1 then apphed a prot^st^ tx « . ^crates X\ii St.hemas froi^i VMI \Mth 

s;o ii oi icg^.nt.!ating a scheiri<' that is scnsanttc ill c^iiist^ic lUc tK nsL si'ciuJ^d ts i l I 0!>l 
sptuftt^aiion 1 Dstd t'K j1 D1>1 (.htm apphc iti i \ (4| o.t \ <i bus tjtss dt l'ij^ i f t o<. m i {jOi i 
\ifcmsoi^ s I DDI repository I hai \M1 dociisneni is ot com st, icpitstnivt. JsuiL t r iv,nts ts j« i ic 
I DDI scheiTia 1 tnall\ usn^g the XMI Sp> ^ ^ beta tool, the I DDI instance document was successtuii) 
\ jhdatcd iismg the «;oheiiia geneiatcd from this* I ML m xici 
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Modeling tne UDDI Schema with UML 

I Nii ctubV's vi^^lnitiod i fa >roi.*t.! nImj^,,.-. s.s s ^ p.^v'v.'i^o^. {hc5C iu illijSfK^.d i-i a dsigtam iKPig file 
fokki kons> opuonaii) a^nnccled v\ilh dependenos arrows A high-level \fcw ofUDI)! 'and .ti. 
relauonship to other specitlcations is shown m tJie following figure. The follo\\fng examples expand the 
contents of the three package* named l!Dl>i, Contact, and Messages in the diagram. 




UDD! 



-'<XSD5d-ie!T;3>» 

Contact 
(from UDOl) i 



XMlAtitibufes ) 



Messages 
{ffOfh UDDf} 



SubsiituJions ■ 
(from UODIi i 



UDDi Core Content lyiodel 

Ac follo'WHjy I Ml cla'>s diagiam iliusiratc;> al! of the case ck'mei ts Irom ihe I DDI ^pecificat on 
ITicre are i.e\esai Imponant points to notjce, Mrst, I followed a common soft\\are design practice vsnen 
naming tha classes by beginning class names with an upper-case letterMhe UDDi schema uses lower- 
*,as«; lettets lo begm all element name-s Several other piominent XML schemas also adopt the more 
oHik-L^-onenU d s rftfvnjL corv^jtf!n>-'s ]c usod hcfc Ths'- vIcsslip rcqjires additional UML md schema 
.MoTTHJi's }o V uc^!ore<! f-j mp !o«cr~v n es t M vs! .pp.> -case complex T>pe definitions, 
V'ct^nd n oukr {v> <ii,<)^% a 'iv^sencr ntsoi u\c tho -cn«.m i generation ptocess. the mode! w^^s 
defined wrM i.^crai I'Xn st<,jcot\ ocs ano viggvd \ak>t^ u- sttrnia.d tcchmq ic that p-irt I \M ) 
Most oftlKsi, r >* slu>\\ii in 'hi*; diagiatn, but dic) <.'id auca liic ^cnu.Jid sJioj.w Alih n^ii sou cafi 
generate a schvaia ttons thiN UML mode! without ysmg uny steieot>pc extensions, tt us unhitch lo aiatch 
im sttijcune of a revcise-cngineered schema without some One-tunmg, 
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Modeilng the UDOl Schema wSlh UM L 



Si.isif:e5-iEiit;ty 
sTstftfi 

IbsjSinessKey :sS:in(5 
j operator ■ stfirtg 
i aiShorlKerfName . .itfing 



DsscoveryURL. 


, 


iiseType : sirimi 

... 







■DH tirsRefefenca 




■ df-<;- <pt(Dn p~'l Sm^iBH 







i Access Poinj 






















■ i HostiflgRfidimctor I 



fciFitiingKey -. string 



SodeiKsy : stiiog 
fifiyNsw: : sfting 
HeyVatee ; string 



iarsg 
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>ClL^Tioi^iyig con 

„ iV^oc lefmg fhe^UDDI Schema wtth UMt 

compit~-u% i ihi can be Jcu>mnlisbL.d sticct-ssfulh thtn oihci pfojccts aiC also 3ikt K to bt, iv, j^tbit I 
ddditfon il the I Ml modeling wa dc nc an mtegra! pan t1 e orjg nal <.chem^ analv ^ at d dt'sjgr 
f!un I nun bef of fiKons stt.tu tc<; i,tmM K esoKed and the schtmrf could be gt.netated ustrg ieue? 

stereotype cxtammm. 

Wfi tViiftoi {his model usug an X I i stskshta tu e\ecitc the tiansJoimatioiis Tnt,\ \ur«, net 
maiua!l\ edited The st,hema generator also mcludes full support fo\ generaSs/at « n (i e jnheniai cej m 
tht I MI model and produces ^ Wll Schema definitions usu g bt>th mplex r\pe ana simple r\pe 
dvHv u on T'clMI tCHOi\TK<i nd '-so<.Mkd nt,('td \ il es nnn'fde contitsi over desiga issues ^s^^^^^ 
as stkt. 10 t thrice >v^qii tiv) r dH to t modcj io l 'i.h <.tM-?ip}e\T>pe dcfinjnoi 
^fKCtttci! on >i ih^ Lmtnt <.;, \v5th n sequence U 'Mi atl thutcs aie unordered m tiie nodd) 

^{ n i 111 tl^H Tinnbu s no ivsociam n lotcs aix generated as attributes or elemet is m the 
\ si! "sci ( tn ui i (. Mtf >i ( riH s n ti a TVO a iOcmlu il end*; ate embedded vsjih or uithnut ro'e 
eSements. ana as rer or tvoe dcclaraoons-;. 



o n at.isrs.> 



y.si'.e : ^."--ant n-jtna-" "disccviSryURLs" >>i.i.nOccurs»="0" m^;xOccvsr.'S«-"^ 



pi i rs Oc: c;xi r s----- *' D " jfta kOccxj r s ~ " vjnjs oundsd" / > 
; i-5C5,'jn--; ssarsf?-- "contacts" nu!iOcf;iu:s-="0" iaaH0cc;ijr!5»"l"> 
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IVi odeimg the UD DI Sche ma with UPL 



\^ f t ^ " * IO<. t. ^ f '^i'^i" ^Cv. 

. .CategoryBag ' < 



t + V 
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Modeling the UDDI Sche ma with UR/IL 



Contact Package 

ill - elo^KPK t 'i isiiu's < mftnmatTon are paK of the i-Oiol'Dl>l sthcma Ho\%cv^' i 

f reut.*utf iv^j: nu paisi^o in m.s l'M( .^odcUo thicc icasoiv fii'-t <^ ,mp ^Uant lo ^ote the 
ss\ijr,iSi na'\l!cijsc ^+ ^ .j^nion c mposKuts T hfs js a uindarv^nUi! eo.i! in b;^( i o senk J iii'J^s''- ind 
acsigfi <ind t.ont3t.f oi in\^to-i m m icIasMv, cxarip't, oi 1.0 thu > eS^'nui t- u\] s j i nio^i c 
b !-,ii-icss <ipph<.al ons ^et.i.nd Ivcujse this pnmartlv an educatiunal i,\«tvi6<.. 1 wantv^d Ui (.reaie „ 
s<,c.-^nd 1 \U package that woi U b«. inclydeJ bv the bduma trai sforjTjatioTi tt ol, 1 bird, and also part of 
th; educat 0 i.'i goj thfs package mciud«i. an k.\pejmien(al mapping for muiuple mhetUanee m I Ml 
m- iieis u WW s>t.hcna Schema does not suppoU mi it^ple mhe? tance. 



1 Contact 1 




pcfscrNare stn-ig | 




<3e5Cftotior (0 *] sirtng 









1 Logator 
kseType (Q: ,1j : string 



<'-XSOs(frpteType> » 
strtng j 



i SEreeiAaaress 


■ Phop.eNiJiTiDer : 


^ EiTiSi' ^dd ess ^ 


adJessl-ine [0 stnng j 






iSQrtCods : string i 







1 phone i 


^ «XSDtopUtf8taeti>sr4» 







"he Locator c! i-- is ,ji absiraci cia.^s jn \ 'Ml (denoied b> 1 s ■ ^ ' - diagtam^, i»o tt if^ 

generated a complex Is pc with an abstract 'ttu.^' «tnbutc M-c. \.<. . .aos sincle mhentanct s"^ it 
ma\ u t cotltplexTypc extension to mher t th^ uti du of <k no- ,u the sLt>o>na ^honeNunihc 
iuheut^ from both I ocator (a complex! >pe) anu straig (a sfn.ple I \ 0^ ds iwn Uom -he Xi>D D.s d!\rvS 
package). In Ais mapping, a simple r>pe superclass t3kei> precedence and genesaies the Lorresp^->na;rg 
feimpicContem chM m ]>hot^e\vjmbcr. The Locator atttlbutes ar«. copied down and duplicated wjthm the 
content model foi PhoneNiimber Finally, all three subclasses mclude a subst tuiionGT'oup attribute that 
allows them to be subs»tltutcd lor 1 ocatorwsthtn ihe ^.ootctu ol a ( ontxi eicnco. 

nentio'Kd paviou&iy,. th's n-'del lise^ upper-cdsc names tne m ide! eiua'tn*^ wt.oKd- iht \ DDi 
scnenia uses io\\t -va-.c lanes thus, ihis- model nKludes tour addsttonal cla-ses ^tt.cot\peci is < 
X*^l>{opI c\ . i tiat cicatc lower-case eletiK^nts in the generated schema (not ihoun nt the 

cod(_ LViTii; '(.Si Vi i-.'as'-es .mc connected wtth a I ML "'seah/aLfon" rclattonship n this irappiSK 
Pms c Hilda I'lodvi ^,1 \ !r <■> -j^uir i {h,>* ss -^h|2htl> nore lemcnt th vi ihc origin i\ I DP! sJi.sm i 'int tt 
^tKcesshilh \a\aa.u ohkmi, I i Ji)! foi.^ nscms a.id I behevc tha! <! mnic K u Ikx ^ hi. 

f Ktndcd umtcntual m.Mie! ot i l>01 icounemems (with the exceptson <n uppe knvcj ^a->^ 'sm csl 
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^ fyiodeling the UDDf Schem a with UML 



~ i .■ ; ■ "\ .'<.::. t-r" ab s tracts" true 'V 
•:i btit sGx oup nsrae-« "LosDafccr . aci: "> 



subs ti fcwt.ionGx{a«p="uddi ; X,oc!stor " > 

< « S5 ! c«jr.p i sKTypc xi «s^e™ " S t r ss S Adcir e sj s " > 

■ free-forsH a<scsr«ss. Typs^d by convsntior. . Sor*. api:. ussd. 

< / xs ; an !) o c a c a ^ 

< / s s ; sfrqvserscs > 

<■■/ xs t'ompl 8-K.eotH:e-a&> 
<xs ; .stt ibuteCJr ocsp n;3:K--.e''"3t: s:«e:S:.Add3;sss . at" "> 

< / xs : s t £r.ibx!teGrcj;xip> 



s«fastitytionG,ro\3p="^Jddx : Locator"/ > 



<i£s ; ©xt0rssi.on bas«="xsd; stiritig"> 

<xis ; attributeGroup ref «"«ddi sirfsaator . att"/> 

.Ui,ox.tc ^ rup «:r»-"uddi;?irtC!r!iar55.;!;)fo<sr--jJ-t"/> 

< / : sirctpl aConcent.> 
xs : cojnp.'i.sxType > 
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{\/lodeHng thg UDD! Schema with UML 



UDDI Message Model 

The U1">D1 spi'cinciU.ion is d'sHned by a single schema and that, .schema also includes eiements (hat are 
the basis for SOAP mes^sages, I spiil ihese defsnitions info two packages in the IML model and both are 
generated into a single schema documeni. The folbwtng diagraai shows a few classes that represetu a 
small subset of the UDD! message sstTOGtures. 



+5)ndQi.ial!f(ef:s 



n3:!T.e?0. 1j: string 
«XSDa«ribisSe» generic : stdng 
-■;cXS03ttrtbyte» maxRows ; mteger 



.,j;discoveryURU 



String 

»0» JfSO OatsSyj!**) 



SusinsssList 1 ^ , ^- ■ , 


«XSDs;t! iEiut8» geoenc : slnng 


*l5US:nessJt;!os : narns sirtng 
--- cSescitpttot? iQ,.*j : siting 


0"" i «XSDsafibut8» busmessKey : stfing 







i get_,busir!essDetai! 

';busirsessKsy j-, "] : smng 

j «XS03Sf Ibut8» gensfic - slrifig 



8us!ness0etali 




«xs6atti-f&uta» generic :- stnag 
«XSDsiSribute» opsrstof : sttirig 
«J(SDa«ribtsle>:=> tattwated : bo»Sean 









sfiiViceKsy [ ! '] : siring 
«XSDat5iibuie» generic : ; 



ServiiceOetsii 




«XSD3tSf(bute» generic : stnog 
«XSDaiUibuts» operator : string 







I BiJSiriessSeiYice 
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Wodefmg the UDDl Schema wsth UfRL 



1 he temawmg examplts iotus on mo of thus*, C DDI messages " * ^ s 5. ^^'^^tai. i an J 
^3 J t r« > Fhese mes\tges tcpresent a request rt^pome pa r m ih*. I HDI pn iiocoi and br.th 
ar^, wMpptd in \P mcssat-C en\etopes when exchanged by appftutiot ^ ^ k ^ rhat the 
mLhtd* <; ti is oti it on 10 Ato or more «i s ne'-«^ r*- i cknuMit^, 
tn 1. lU i f in \sk6 nW p'-cxn s settion \oitce al o that an txnatop-kvel eiement was 
! f ! (}} tsn wn !nthedkig}dm)thatm pstol^tuppel-caseeomp^exType 



x^i * te-^^ t € -^"iv Busin«ssEnt3.ty 
" I^~ 
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_ _ Modefi ig the UDDI Schema wrth UfiffL 



Sample UODI <businessDetail> Document 

SOAP mes^. i 'i. ^ n(,k ii, i i'it,'-> liK lolifmnv' < , mcv-ifi^c is l in ci removed 

the Sf)A.I' <:inciope tiements that umpped this jusponsc mtssagt* and mxiitra tK dutauk namespace 
Jeciar^ tton to assjgn nn iesi namevpace but othemibc the message is evacth as jeatn ed. 

\ V r ^^"'s f^ta-i ill " 



V 3«t, -"^S.-* * <^ -iS P>A »^A' ?/■> 
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J/(ode!mg the UDDi Schema wttSi UML 




< / tl-5c-d«.- i i V! s t «ViC § '0« t a i 1 s > 




i !-or d t.;uidt, \ery acccssibJe introductjOT to I'ML and its graphical notation, see: M«£lis> Foibles, 
UML DLmlkd. second edition. Addison-Wesiey, 

2. Object V1anagemcn{ Grnup VAE Metadata Imerchmge iXW). version 1 , L See 

3. For G^irent IJ0131 spectficatiQfis. see hUp;//www,uddi,org 

4 }\ iPDI li. an ctpcn»soi(iTC Java Itlirary for lIDOl, isee httpi'M-ww jud<Ji org 

'\ iortht ominii Jests i>->es paxc-scs and design techniques for geueratmg XML DTDs and 
ischci-i.'s .oui ' \n ni>)"!tK Scv* L\\ui C arKon, A^fo(4'/w^ Am TV//, AddKsOn- 

W<;s!c>. 2()r' (to sMjhush<.'d sn Apui 2001) 

6 A W^b porta! has been created at http:/'XMLModelmg.com to aggi egale no\^ sfcc i-s < jui resource 
references related to modeling XML \ocAb«iaries. e-speciall> u&tng UMl ^ siJe ais^o contam 
e\amp!es from the book, p'us case study exampies of modeting XMI vocabyianes 
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UDDI Programmer's AP1 1.0 

UODI Fyblished Specification, 28 Jum 2002 

This version: 
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Latest version: 
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DariigJ Rogers, Microsoft 
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PASS* 



Document Overv{«« 



fhfe l,r>fmon{ de-^cm>^s thr prt^g-^moit'-g tfrtetfaoe that is exposed by ail snstances of the 
Unfvc^<v5i Otb. nption Discwery & inti-gration fUDDi) m^istr/ The prtmarv audtence for th.s 
fUcume-it !s p og-ammeis that want to wte software that wi! drectly interact wth a UDDi 

OpemterStte'. ' 



Up. is -amtj 3 grrijp weivbast d legistnes that expose mfotmgtion about a business or 
ot„8f c V and its lerhmca! tntettaces ^or APi's}. These registrtes are by mufepte Opera/w 
.srfei ard csn be u&ed by any business tttat wants to make their informatfon available as we!! as 
an/one that want,, to find that infomnaton. There is no charge for usjng tne basic semces of these 
operattng Sites. 



By accessing any of the pubhc UDO! Opsra'c- S < ^ . > - f . if < m . i.o i about v/eb 

services that are made availabfe by or on K k ^ . i m ( laytnr' access to 

Jh!s trrformation is to provide a mech3rs'> , , ,,-,^"1 ischrVai 

programming interfaces am provided for ^ >uro.osss ss 

electronic comfr^erce. etc. Ths benefit to ti^e I'^ai^icj^i >u-in< rr,o<.^.x} o>po5>ur» in ?n 
eiectronfccomrrieroe enabled vsssrtd. 



The information that a business can register indudes severas kino? of sfmoie oata tf^^t hoip otrers 
detenitnc the answeis to the questions >ho. what, where and hoW Simple infoimation about =5 
business - mfoimation sucft as name, business identifiers (D&B D-U-N-S Number®, etc), anu 
contact in ormatson m^^mv& the question mo?" "Wtef?" involves cfassffication fifarratfon t^^at 
■ncKjaes trd^sta' cocIps and p>^uct ctassifjcaftons, as we!! as descriptive mforrration adout tie 
oC-\ -,e<? t-^at = e ax'aiiabit, x-r elecironic inferchanga. Ansvirenng he quesfeon ' VVftefe?" ftivolves 
-eg!ste-,>ig iri-omatton aisodt the URl or email address (or other address) througn v^icn each type 
of service ss accessed Ftnafiy, the question "i^^ \% answered by registering references to 
information about specricatfons that desonbe how a parttcuiar software package or techntcai 
interface functions These references are called tModets in the UODl documentation 



This programmers reference coupled wth the UDDI APi schema (uidiAP! xsd}. defines a 
programming irtterface that Is available for free public use Software dsvslopers. businesses and 



'^t^ n't ^'J' ^^^^ ^ ifuf^esmeiit^tiisn erf this specfficaSoft ihst partiopates in the pubiic mjd of UDDi sites 

■ Tiie x^n-:, r.«ss .s i.sec! \<^ a gen«,r„! sa«Sf: to f^er to an operaJSi^ cfificef n or any other type of tsfosniistian flirouatooi fii,a 
ciwumftri!. Thte «s€«0M-(fitenae!EJ^pr«s«d8 oltier organifcaiiofial fort«3> 

a'tr.v^,vv. ,s J o■r,^.ise,^.ooe^J'?!Jcxcy:fwd■sgfv«osth8tar«expc»erf^ri8scmepJDtes*^^ examples irwiudfi 
PL«^v!i3si.-5s :,.-.-c.:s oj-a.->3 ..-^^ces. Search swwes. shipping or posts^ s«>«e88 exposed ovsr tranapofis iiise HTTP Of eteifmc 

]^rhe i>>fcwr.it.!>n sbouS ^« service pgin; or address at '^hfc^i a service is exposets is smietimes rsferrsiJ to Mssnq ths teciir«^ 
iW(;,r^j«?af«Mtort. design spsc&fsfef 50 8^ using the term SMfrj^rempfe/s. « .r.sca. jeni^ 

JUNE 28. 2002; 
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others are encouragsd to deSne pfoducts and tods that make use of this AP! and to buifd ?«gistties 
mt are compafiae with the APt defined in this speeificaifofi. 

in order for two or rrsore pieces of software to be compatible with eadi ote - tiiat is. compatsble 
enough to be abie to exchange data for the purpose of schievirrg a desirat^e resutt - ttiey must 
share some design goals and specifications in common. The registry informatfon modsi that each 
UOD! site supports is based on this notion of shared specificatioris. 

in \m pc?sL lo DU:!d comprttiiife software, two companies orrfy had id agree to use the same 
SDeciftaBtiori, arid ifien test their aotere However, v-ith UDDI. cortipsmes nesd a way to pubhsh 
infoiT.intion aboLit !!>e Epeciftcstions end versions c' ,%-.BC'f<i-3hom that v^-era used to design their 
fioVems.ed 5:«rvic:tJ'; To accomniodafs the n-*e':i tc o --t —^i.y d(r■;i^/ public sfiectficaiions {or even 
pnvate soensfirattons shared oniy with seiocf p,?'^Vi..s -Sc.'.r^atlor; about the specificaiions 
ti^■•itr!^^t^ve3 -lesids xo b--i discovera^e This !'■!foi7r^3^;■!> .ibojl srecificaSions - daps^-; i-netadsta 
coru^^rurt ~ fs C3;i^^d ..n tMode! wi;*^;-. [j2D' 

The tivlode! concept sen/es a usefuf purpo.'ie in discovering iniormation abour se.'\'ices that are- 
exposed for iaroad use. To get a dearer und®^a^dir^g, lefs consider an exannpte< 

Si^pose your business bought a sofNare paci<age thar 'et ynu- cuto'-i . , < c 1 c^'>nc 
orders via your web sita Uang one of the public UDDi sies you !;< Jr .'!v',(i s<> the 
avaiiabiiity of efedronfeeomrmrce capability . 

One of 8ie reasons you chose this parScuiar Kjftware package was its wicespread popuiani^,' 
In fact the salesperson that sold you tie software made a point of highlighting a feature t.'-tat 
gives yeuf new software its broad appeal ~ tt^e use and supjaort tsf a Wefy used set of XiViL 
bMsness documents to aosonwiodate autonriaSo busSriess data intisi-chahge. 

As yoy tnstailed and configured your new software, this software autcsnatically consulted one 
of the public UDDi sites and identified compafibie busriess partn^. it did this by looking up 
each business you identsfted, and located thc^e that had already advar&seci supDort for 
etectranic commerce sewices that are compatible with your mm. 

The configuration software accompiishes thfs by tai<fng advantage of the fact that a tModel has 
been registered for a fui! spedflcafloht, and tie iSfervicje elements for each bu^ness, tfve 
tMode! keys for Sits spec^caSon was mfefenced. 

in gener,.;ti it's pretty safe to think of the tMcd^j' Kev- 'i.---^ 3 -,e-S!rs de-.cnption as a fingefpnnt 
that Gfin be usee; to trace the compatfbii.ry ongi.^s c" 3 i-er.'-ce Sinc^i msny ^.etv-.-es wil! be 
constructed or programri-sed to !5e compatibie ywtii a givej-s spscification, references to infonriation 
about spedficates (by way of tModei entnes atid tiviodet references) dont have to be repeated 
wtth each registerad electronic C£*nmeroe service. 

For progremmers ttiat write the software that wSil be used by businesses, tModeis provide a 
common poirii of reference that attows compatible service? to be easily identified. For businesses 
that use this software, the benefit is greatly reduced work in determining which particuiar seivices 
are compatibie wi^ the sofi»^are you wnte. Rnaiiy, for soft//are vendors, and standards 
wganizations, M ability to register infomation about a specifieatto and then find trfipiementations 
of web sen.'ice$ that are corrjpafibie witi a given Model helps customers imtnediateiy realize the 
benefits of a widely used de^gn. 
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One of the 'mmedtate benefits of regt&terjng business irifmyiato at one of tht- JDnt l >pcry ;r 
lnstanc0S is tiie abiStty to specify one of more dassificatson, or category codes for yotsr DUfiinoiss 
Mmy such codes exist - NAfCS. UN/SPC S!C Codes etc - and are wdeiy used to dassfy 
busine^ises industnes 3rd product categones Oth^ (and there are many) dassificattons 
cf^riqn to jeogrrohjc fnformatjun or membership in a given organszaffon 

E?zf- ijODi fetfj provides ^ w=ty to add any number nf dassfficattons to a business registration 
This i.Tfamk'iton aliow«? m-pie sr-archmg to be oone on ttJe tnfomiatson containexj in he public 
regtstnes More fmpotart >etjfstf'nng infomiation such as tndu&try codes, n'-ooict cooes 
geography codes and bus less x i ^ntficaLon codp^ {s< tcb as- C&O D-U-N-S Nj..s'^beiNi'; t lo^w cfhsr 
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iPASE? 



BBBSSB 




The ODD! progiwrtmef^s APl fs d^signeci to ^^p^ P&quest/respdhse mscaianisfT) thst 

allows discoVesy of busness^,^^ 



The primaty prinapa! guiding the destgrs of (tsis programrriers APf v.'as simpiicKy, Care l ias been 
taken to avoid cosripiexity, overlap, and also to provide dirstS accsss to the appropriate ievefs of 
fegtstefed infomstson vs^h a minimym of programming oveftiead and round tPipping, 



Accessing UDDI pmgrammaficalfy is accomplfshed via AP! caifs defined in itiis programmer's 
refenence. Two types of APIs are d^ned, • A put^isliets APJ is provided for interactions betm&o 
programs and the UDD! mgistry for the purpose of storing or changir^ data in the registry. An 
tnqiftry AR is provided for programs that vtarA to access Sie regis^ to read infofmation from «ie 
registry. 

Autiienticated sccsss is required to us$ the publishers API. Each Curator Sm is responsible for 
selecting and imisJementing an aiHh^iiication pmtecai im is compslifale \Mth thss publishers APf, 
as wei! as pn^viciing 3 new user sign-up mechanism. Before udng any of the publisher AP! 
functions, the oaier !$ responsible for signing up v«th one or more Operator Sitm or ccsrspatibis 
registiies and esSa&iisi-Jing user credentials. 

Tha inquiry API functions are rj;<po.s<;a as SOAP snsssages over HTTP protocol. No 
suti-fenticaijon is required to make use of fh& inquiry AP! functions. 



in any programrr.ers APi, as well as any message s«t, versionintj ijvsueb atf;?'-;- 3a iime passes. 
Ciianges io an APi over ttmQ car- !-es«.j!t in i-esuests b^ing iTiisundsrstorxi or |:-!ocyssed incorrectly 
uniess en.-! csn deiarnvne wfirjiher jr^e versio'^ of n-vi APi being nr(;\';o\-.-d ifu-ri-fi:;!; ={ie version of 



in order to laciiiiate a propet gr.d controiied vsfsiori frsatch, trie entJ.re APi defined by tliis 
programmers reference is version stamped. Since the API itseif Is based on XML messages 
transmiSed in SOAP envdopes over HflW, this version stamp takes the form of an mt attribute. 

All of tt^e messages defined in this APC must be transmitted with an accompanying apiMication 
vereion attribute. This ^rjbiAe is named "genefid^ and is present on sU mtssagei.' Eacn iirne this 
speciffcaUon Is modiHed, art ensuing requirement is placed on all Oi^eiBtor Sn&s to support generic 
1,0, the cunent generic and at ieast one prior generic, ^ any. Compatible registries are 
encouraged to afpporr at a mlnimiim this 1.0 version. 



■ HTTP n j.^,:fj s, g£..n.3.-«i ;,-3-,r, hwa HTTPS i$s ys«i sxciislveiy foraiioraieo^sdirfirfec! iniheou»hafs APt. 

■ V^->i..j,i,t-<c! Ar,ri!i.\=!fci^ eshavicr i? acca iw^iosiaM via the gefle* atlfftiute intctependefiay fwn *6 stfticlurss defirssrf in ftts 
acx.om;>sr.f.r>a schema, ;n oftn^ai. ^iiis kirrii cf vsrsloni*^ pret«f«bS6 because ftis eaeifif tospecifysnew behavior agasst the 
sams strufSu.'cs Shim -o !r,' ssvi ^^i tSata stnscture d^itons to fsficsot tsa^itiftss tim. ymiminQ «>e actuat schema strutaufss 
vyooitf psiesenteonsffjs/abieieehntea cJrtTfcuiftes after mtsrs iiisn a ismai! riUfti&er c*ff<^jSoy«t applicstimsexisteei. 
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tl-se API used by a requsstmg party 



SOAP fHessagins 



SOAP is a method for using Eictensibte Markup Language (XfVtL) for use in message passing and 
remote Drrcedure c?!>. (RFC) protocols. SOAP has fcseesi jaintfy defined and submitted to ttie World 
Wide vVeD consaftajs^i (W3C) for consideration as a stancferd web protocol, 

SOAP ts being used in conjunction wtii HTTP to provide a simple mechanian for passing XML 
messages to Operator Ssfes using a standard HTTP-POST prc^acoi. Unless speckled, ali 
responses vwit toe retum^a in the normai HTTP riasporise document 

See the appencfix on SOAP specific ifnf^ementations for more infom^ation on tf>e way that UOD! 
Op^mtor Sit&s use the SOAP schema as so erweiope mechanissn for passing XML messages. 

The pragramming interface for UDD! is based on Extensible Markup Language (XivlL). See the 
appendix Q<ML usage detaSs) for mwe tofbfmatior> on specific xm. constaicts and (imfeitions used 
in the specificaSort of the programrrsers intetfac^. 

The first fine of error i^podsng is go^'smed by the SOAP speaiication, SOAP fauit reporting and 
fault codes vsli be returned formost iovalid requests, or any request vs^here the intent of ttie'calier 
cannot be deteroiined. 

If any appiicafion lev^ erw occurs in processing a request message, a dispo^tonReport stnjcturs 
v«ii be returned to the calter instead of a SOAP fault repott. Disposition reports contain en-or 
information that indudes desoipfens and typed icsys that cm be used to detewine the cause of 
the error. Refer to the appendix 'Ztvor Codes" for a gsneraf understanding of errar codes. API 
^ecific intetpnatagor© of error codes are described foiiofwi ng ead^ API reference page. 

Many of &te API constrads defined in ttiis document aildw one or more of a given type of 
trrfoffnatioTi to l3e passed. These AP! cails concepfeaBy eadi represent a request on 9ie part of tt>e 
caller. The general error hanEiJtng fe«e^nient Is to detect erram in a request pnbr to processng the 
request. Any errors in the request detected \A^!i tnvafidate the entire nsque^v and cause a 
dispositionRcport to be generated vwthin a SOAP Fault structure (see appendix A). In tiie case of 
an AP! ceil thai swoives passing multiples of a given stnjcture, the dispositionReport vwll call out 
oniy the first deteded error, and is not re^ni^ble; for rspdrting miMiiAQ errors or rsfiecttng 
intetnjediate "good" data. 

Operator Sites and con-.patibte impier?>ent^ions v«fi store ait data exactly as provided vwth one 
exception. Any ieadfng or trailing v»^ite space characters be r^wved from each tieid. element 
or attribute. White space characters inciude carriage returns, line feeds, spaces, and tabs, 

Despite ifs crrjss piatfomi goals. XML still perrriits a broad degres of piatforrr' dependent ordering 
to seep into softv^'Bre. One of the Key areas of seep has to do witrr tiie way thai r-nufiirjle language 
encoding is aSSowabis in the XML spe^.- r,^t.o- .=cr rhe purpose of this sc^eciflcailon and aii UDD! 
Opetisior Sites consistency in ivunc^ j -J asia <s essenfi?!!. For ihis reason, the default raiiation 
orxler for data reg'ster^d vuitNn an Operator Site is Ijir^aty. See appendix B for more ir^formation 

4Um 25, 200? p^^,g g 

■S? COPYRIGHT aOO!)-?002 BY ARtSA, iMC. im£«NAT10NAL SUSINSS-S WCH!f*!£S COi=!POHATtOW 
AMD M!CftOSOE-""t GaPSPORAT)0>>i. 
ALU HiBHTS fSesefiVED. 



related to the use of byte order marks and UTF-S and the way {tie SOAP listeners corwert a!! 
fe<|Oiests to UniGode prior to prpcf ssfng. 
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Th!s APi refererice ciivioec into n iogicsf sections. E&dh section addresses a jjarticiilar 
programming focuis. The sections are arranged in order accofding to the most common uses, and 
within each section aiphatfetically. 

Speciai vaiues within AP! syTitax exampies are shown in itaffce. !n most cases, the foilt>wing 
r^srsnce appfies to these values: 

• uuid^kw- Access keys within ali UDDt defined data ^anents am represented as 
univeri^f unique ider^ftens (these are sometitnes called a GUiD), The name of the 
element or atttibufe designaftes the particuiar Key t/p& 8iat is requited. These keys are 
atvyays; formatted ®;cordfng ta DCE UUiD eonvenSons vMi the one exception being 
tModelK^ ues, which are pmfixed vt^ a URN qu^ifi^ in the format "uuid:" fdiowed by 
the UUiD value. 

• gen&ric: Tints speciai attnbuts is a required rrstadata eiement for a!! messages, !t Is used 
to designate the ^>ecificatton x'ersion used to ^or;T<3t ihe SOAP message, in the 1,0 
version of the speciScsfion. this vrioe ss; requtied to ' i.C A-'iy oihsf value passed can 
result in an E_unsi.JDPQrt8d etror. 

» xmlns: This speaai atmbute !S a required n-^etadats element tor ai! r!!--5r-sa{)es. 
feci-infcany, it isn't an attribute, but is fon-ngiiy c;2!ied a i-^-nm- ^vpaf a Qufsiifif-s ii ut«c; to 
designate is a univsrsai resource name (URiMi vaino tnaf n.;?:!tvoc! i-.i! 311 uyrerer^ci..;; to 
the UDOi schema in the 1 0 v^''^.\>-' --Tf t^le specif^^anon, tu^s value rOjUired to be 
■■■urniuddf-orgLgp!". 

» findOiislmi-s' Tnis &pecia< e-j-nent fs found m liie mquify APi functions that are used to 
sesrcri {e g f]nd„ij:nd)ng. iind_busfness, ftnd„se(vice, fincLtModel). This argument is 
used to sigfiai spocsai behaviors to be used v«th seardiing. See the Search Qualifiers 
appendix tor more information, 

• maxRov/s: This speas! qualifier is found in the inquiry APf functions that are used to 
searciT {e.g. find^binding, f3nd_busfness, find_sen/tce, ffndJModei). This argument is 
used to iimit the number of reajits returned from a request. When an Operafor Site or 
cxsmpatJWe instence retifms data in issponse to a reque^ th^ csntains Ms limiting 
argument, the number of r^lts wii! not exceed the integer v^ue passed. If a result set is 
truncated as a re^iit of applying this limit, the resuit vM include the tnmcsiied attnbuts 'Aith 
a value of irm. 



tfunciitod: The toincated attribute indicates that a rtiaximum tui-'viber of possible resuits 
has beon rsturne:). The actua! linii? s-^t for appiying thts treattnerit is Op&raior S/fa> poiicy 
specific, but in general should be a suificientiy large nurnbsr so as to not normafiy be an 
issue: No ijehaviors suet"! as paging mechantsns are defined for t^tnevtng n^ore data 
after a twncated iim8. The intent is to support the average query, but to allow Operator 
Sit&s the lee>A;ay required to be able to manage adequate perfamanee. 



« categary5ag. Sesrcnes can be performsd baseo on a cross section of categories. 
Seve-ai catsgoties are ijroadfy supported by all Operator S'tes. and pwde three 
categorization dimensJons. These are industry type, pnxiuct and service type, and 
geography. Searches involving a^tegory inform^ion can be combined to cross multiple 
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dimensions. For this reason, these searches am performed ragtdiing on ALL of the 
categories auppftecJ, The net effect in generic t ($ the ability to use embedded category 
information as hints aix>ut how the registering party has categorixed themseives, but no* 
to provide a fut! thitxJ party categoiization faditty. This is the reaim of portsfs and 
mari^etpteGes, and may m enhanced m future genencs- 

• id&itifiorSag. Searches invoiving identifiers are perfomwd matching on any suppiied 
id^intifSer {e.g. D&B D-U-N-S Numbet€), etc) for any of fr.s ^v.maiy BlemtMs that hsve 
identffierBag eiem&nts. Fiieso searches aiiow broad identity matchj-iy tjy returning a 
rr-saich when any keyedRe'e-e'-^ce L.?<5d to sea-cn idemtfisrs matches a fsgisiered 
identifier, 

« tMoa's-lEkng- Searciies thai ."-.sich .s p3r5:':ii.rar tsd^.r^icai finysfpfint uss UUiD vaiuss to 
sesfch ior binding? emplates witn matci-iing tModesKsy vaiue seis Wnen u?ad to searcii 
for vj&b ser\/(Ci5s (e.g the data descnoeo !>y a bindiiig'Tenipiait stnjcture), the concept of 
tWodef agnatuois ^^Slows for -vghly selective searches ior specific a->rnbinat!ons of l<sys. 
For insta te try i^xioiev.o--- y A---n ;v.r.".---- t-st l-niTiements ail of ti^e parts of the UDDI 
spaafinnti.-- 5 ..^u t", ac..\-"ru->,.;i >.y -vviKh 'v,, for a cofTnijtnaiion of tMode! i<ey values 
that corrssponc! to the full sei of specificafions [ine VDD\ •sp-jciitcofton. for instance, is 
divided into at least 5 different, separately depioyabie tfvtodets). Ai {he !i;=!fne time, limiting 
the number of tModeiKey values pa^ed in a search can petinsm i^foads! ;^earch8s that 
fool< for any web service that !mf^m«nts a sj^cific sub-pari cf th<5 fuii spscificatson. Aj! 
tiViodelKey values are aiways expressed using a Universal Resource Name (URN) format 
that starts vwth the characters "iiU(d;*'fdiowed by a formatted Universally Unique idsntjfief 
(UUiD) con^sting of an octet of Hexidedmaf digits arranged in the common 12-4-4-S 
format pattern. 

in ai! cases, the XML strudures, attrtijutes; and element names shown in the API Kcarnp^es are 
derived frofri the Mes^ge AP! schema For a full undefstandif^g of stwcture contents, referto this 
schema. It is suggesti^:! ifeat toots that undi^tand schemas be used to generate logic thai 
populates the s^K^nes used to make the API eaSis against ari 

Three qtser^ iJatterws 

The inquiry API provides three forms of query that follow bnsadiy used convsnSons. These two 
forms match the needs of two types software that are fradi«ona!!y used with registiiss. 

The ismwse {»£ittiem 

Software that aliovvs people to explore and examine data - espedaify hiefarchical data - requires 
browse capabilities. The browse pattern characteristicaify invdves starting wth some broad 
InfOTTiation, petfoming a search, finding general result sets and then selecting more specific 
infc»maflon for drtiWosiW. 

The UDDI APi specificateons accommodate the browse pattsni ijy way of the find^xx APi c^lls. 
t hese csils. fr>rrn the search c^ipabiiilies provided by Ihe AP! arid are n-iatched with summan/ return 
nie?sag"js ti-'at retusn ov<?n.'isw irfofr^^3^o!^ about the registered infomi^iiioi-: that niatoh the 
sopDiied search crrtena. 

A typtc?5l Prov\^:,e sequence 'nigr>{ ir-v-o' finasng vvtsett^r a particuiar bsisiness you know sisout hss 
any informat'on rs^^isiered. Thl? sequence would start wth a cali to finci business, perhaps 
passing the iew characters of {he businesses name that you already i<;now. This returns a 
buanessList resuit. Thts result is oven/iew informato (keys, names and descriptions) of the 
businessEnfity infotmation that matched the search results returned by find^business. 
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!f ycu s{>ot the business you are iooktng far, you can dfii! into th^r ixisinessSetvice infotm^on, 
iooking for partiouiar service types {e,g, purchasing, dipping, etc) using the }incJ_servfce APi cafL 
Similarfy, If you Know the tectinica! {jngstprint (Ifvlodei signature) of a parScutar product and want to 
?ee if the EBusiness you've chosen supports s compatible setvice interface, you can use 



Once you have a hey for one of tfie four main data types managed by a UDD! or oanpatfbie 
ragistiv , you can use that key to access the fuii registered details for a specific data instancis. The 
cument iJOi:)! di;i{;? iyp-a are businessEntity, busirtessService, bindtngTsnipiate and tModef. Vou 
can access the fuii registiifed if^formstion for any of Siese stoictures by passing a relevant key type 

to one of the get^xxAPi caiis. 



Contir-i!jtr>g th2 example from the previous sscfion on brov.«;ing, one of the data ftems raturnod Oy 
aSt of the fmd^xK return sets is key infonnatior:, in the case of the business we were interesteti in, 
the businessKev - • .-. ; . :■ ■ ■.: - ,.; ;;:.3!r,essUst structu^s can be pasised as 

an argument to ■ - : i-.-'j-t! to thts maasage is a bus^incssDauii 

message contairiing the hjis t^jisterec; )r;fcn'nat!::'n for tm safety w{->ose key vaiue was passsd, This 
Mi! be s fuii ftt/a/nessgiiffSystfUGture. 



iiiwocstjoo isattem 



In order to prepare ar; appiication to take advantsge of a rernote weir- sea'tce that is regis-tersd 
within thir: UDEjI reaiatry by other busineases o:- ':-:r!t;tias, you need to prepare that apiJltcatiori to use 
ttie infotn!;5ii;)ii ioi;;ii in the registry for the specific seMce being invoked. This type of crross 
busfner>:; :;(.:;vi .-ias traditfonaHy been a tasK that Is undartaken at development time. This v^ill 
not necessariiy ctianga compieteiy as a result of UDDi registry entries, but one significant prob!^ 
eah 1)6 managed ^ a particular invoeatlon pattern Is emf^cysd. 

Data obtained from Sie UDDf regisfey about a tmdingT0mpfat0 (ntomaSon set represents the 
instance specifics tsf a given remote ssn/tce. The program should cache this tnfomiatton and use it 
to contact the sen/ice at the regtsiered address. Tods have auttsnated the tasl<s as^iated with 
caching (or hard coding) iocafion infofma^on in previousiy popular r^nole procedure technofogies. 
Probiems arise however wtien a remote service is mcjved without arty kn0Vi4edge on the part of the 
caii^. Moves occur for a vanety of reasons, including server uf^grades, di^ster recovery, and 
servioe acquf^'on and busness name change. 

When a CHiil fails using cached infofmation obtained from a Ut^D! re-g;st!7, ihe proper behavior i.s to 
query the UDD! registry where the data was obtained for frssii bindingf aripiate infomiation. Thpj 
proper caii is getJblndingD&^ils passing ihe original bindingKey vaiue, if the data returned is 
differerrt from the cadied Wormafion, the seryiee invocaScsi should automaticaliy rety. if the result 
of this retry is successful, the new informafion *ouid replace the eached infoirriafcn. 

By usifjg this pattern vwth web services, a bt-fsii^ess using 3 UDDi OpiVp.io! Site can automate the 
recovery of a large number of partners witiicut ijr.due cotnmuntcaticn and coordination costs. For 
exanipie, if a business has activated a disaste' recover^' sife most of the calls from partners v,.ill fail 
whert they tfv to iavo!\e services at the fated site By updat-pg the UDDI informafion with the new 
acidress for the service, partners who use tt-;e :nv>xation pattern will automaticaliy locate the new 
semce infomiation and recover vwthout fufttiet adnwitstratrve adion. 



* Key? witrstfi UOOS compat»we fsgisififis that ar^s n<it Op0i^»Sk«s. m sv«chrcifi««! wi^ keys gweratetJ by OfseraferStes. 
There fe (to key porisbS'tj frssiiarsism definssi fijr crossing froni a repJicA'srf Of«ratof aits to a c<3fnp8!*j^6 resistfy «iat is rsoS part of 

0 iSOPYRiGHT eV ARf8A, if^C , t^iT6fi^iAT)0^}AL 8US1WESS MACHiS-JiJS C0RPOR.A HON 

AND JiflOtOSOi-T CORPQRATiOfJ. 
AU, RtGH-rS RESeRVS-O. 



Inquiry API ftirtctionis 

The messages in this section represent inquiries thaS anyone can mai<8 of any UDD! Operafo/- Site 
at any lime. These messages ai! behave syndvonously and are requif^d to be exposed via 
HTTP-POST only. Other synchronous or asynchranous mechanisms may be provided at the 
discretion of the irtdividuai UDDi Operator Sste or UDDt oompatifc^e registry. 

The publicly accessible queues are; 

e Hrsd ^bii^ding: Used to iccate sixjofic biridings within 3 registerad businessService, 

Returns a binding Detat! message, 

» ntid_business: Use<i to iocate -rto^isUQ--^ abojt one or niore business'ss. Reiurns a 
btJsinessLtst message. 

• find^service; Used to iocsts .soecif c .■seryicei ^t^^r- 3 !eg;si&r>rf! bDsmes-sEntiiy Returfis 
a sefvtceLisl mesKige, 

• f!nd„tMod8i; Used to locate one or n-'.ora iyods .r.f.OTialion structures. Re!!.;:n3 a 
tModelUsi structure, 

• get„bl««iingDgtsf!: Used to get fui! iiindingTempiate iniomiaiion suitable makiixj one 
or more ssn/ice requests. Returns a bindShgDetaii message. 

• get„b«sines^taS: Used to get the fu!! bt^nes^nttty infOTi^on foj- a one or more 
businesses; Returns a businessDeiai! message. 

• f 8t„b«s»n8ssDetaiiext Used to get eskiemied bustniassEntKy tnf{»TnaSon. Returns a 
businessDstaiiExt message; 

• get„serviceDet8l!: Used to get full dstatis for a given set of registered businsssService 
date. Returns a serviceOetail message; 

• get^tft^odefDetai!; Used to get M details for a given set of mgtstersd tfllodei data. 
Returns a tlvtodeiDetai! message. 
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The find__binding message returns a bindingDet^y message that contains a bittdingTempl&^s 
stnjcture with zero or more bindingTsmfdate structures matdiing the criteris specified in tfie 
ar^jument iist 

Syntax: 

xm!ns="Lim:uddi-org;apt" > 
l<findOuaMisrs/>] 
<tModeiBag/> 
'e,'f}nd_b(ndtfig> 

Arguments: 

» iTjaxRows: This opBonai insegar vaiue allows me reques^ng pnogmm to limit the iiumber 
of resuifsretumedi 

• serviceKey. This :A/r,', ^ry s --.^d sper-iy parttcuia^- instance of 8 bu^nassServrc© 
eleme;^; in the Ovjisu-e-i Cniy iv-id-.is in ffjii spedfic businessSemce data 
idenfified by ths servic-eKey |>ass.e.i ^-.ri ix; se;rc'>r:(l 

» mdQmm^9: TNs coitecSon of fin-sQ- ji^^rie; -liomenjs can tx; u.s«rf io aiter sh.:; default 
l)eh3vtcy of search funcSon^ity. See the Search Quaitfier s appendix for mae infomic^Jon. 

* mod^B^, This is a list of tWod^ ywaTteF values that repre^tit thetet*tn?caf fingerprint 
to locate in a bindingTmiplate stmcture contained «4thir* 8ie busnessServ/ics instance 
specified by the ssviceKay vaiue. if more than one tModef key is specifigd in this 
structure, only tjindingTemf^ats in^oftnation that ^acfiy matches all of the tModsi keys 
speci^ed wilt be returned {fogicai Ai^iP). The order of the keys in the tModei bag is riot 
relevant. Afi tModeiKsy values begin with a uutd URM qualifier {e,g, "uuid:" foiiowed by a 
i<nown tModef UUiO vslitm. 

This function returnr. a btridrngOetafi mess.3ge on success, in the event that no matches were 
located for the specified aiteria, the iiindinr^etail structure returned in tiis response the will be 
esTipty (-3,3 contain no bindingTernplate <i3ia ) 

in the even of a large number of matdies, an Operator Site may truncate the result set. If this 
occurs, the response message v«ii contain the tn/ncsted attttbute with the vatue of this attribute set 

tOfft?& 

Searching using tModelBag wH aiso returr any b'ndingTenipisis infomiatton that matches due to 
hosfingRt-directcr refereiicss. The re&olvea anaingiamplate slracture vwit be nstumed, even if that 
binding i empiate is owned by a different businessSen/ice stnjcture. 

Caveats: 

if any error occut^ in processing mis message, a di^osltfonReport structure vwll be nstumed to tie 
caller in a SOAP Fauit. The fssllowing error number information will be relevant 
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* EJnvafldKeyPassed; signifies that the wkf^key vaiue passed did not match with any 
known senviceKey key or tModei Key values. The error structure wi! signify Vi^tch 
condition occumgdfirst, 

» E_tooR9anyOpt{ons: signifies that more ihm one mirtuaiiy sxdusive argument was 
passed 

• E„unsupportecS: signifies that one of the findQualifisr values passed was invaiid. 
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The find, business message returns a businessList message that mstches the 
cooditfons specified in the arguments. 

Syntax; 

<find_busin8SS s©neffc«"1.Q" [7j7ajf;?Q4ys="nn'' | xmfns="um;udd!-0Fg:ap)'' > 
[<fir}dQm{mrsf>] 

<mmBt> \ <ident^er8a9> ! <category8ag/> i <iMode)Bag/> { <discovefyURLs> 
<^t>d„busfness^ 

ArgutTierjts: All aipuments to tiis cati listed are mufeally exclusive except ftndQuaiifiers 

• maxRows This optional Integer vaius allows the requesting program to iimit the number 
of resuits returned. 

« fmdQuali&ers This coflection of finoQua^fter e-iements can be used to alter ins default 
Ix^iiaviof of searcii fur^ctfo^(a)f^/ Soe the SsmM OuaiiSers appendix for mom infop-naJjon. 

« name: "nis string vaiuo i& 2 partai ns-^-ig The bustnessUst t-eturn :;ontains businessinfo 
st)!;c!uf8i fof iju<,<r:e<^%" ./o -^..vch-^i ii-e value passed (ieftmost match). 

« Identm&i-Bag: K~ - ■ ritf^ttfiii.- rgfeetxies The returned businessList 

osntgtns bi is-nesslnto ^- s.v. ^ ^ ■ fv, -\ iho luentrlers passed (logics! OR). 

* categofyBfig r^i:; - o*" oatocory r-'-'e-O'-O' s Use !e;!..rn6i businessbst contains 
businessinfo ^ructutes n.ata -1 nc; r; 'hi - s-ctjo p?!osod {'nq'Cai ANH) 

* J^ode/Sag, The registe'-eci bu^-ines&tiit h o^'i?. .^.^yrw btndtr>-i f smpinU^s, that in turn 
contain speofic tMcdei references The IModeiSug aigumeot ists you search for 
businesses that have bindings that are compafebie with a spectlic tModei pattern. The 
returned bussnessList contains bu^nssslafo structures that matd-< all of the tModei keys 
passed {logical AND), tModeiKey values must be formatted as URN quafifted UUID 
v^ues (e,g, prefixed vM\ "uuid;") 

• mmmyURLs: This is a list <^ URL's to bs matched agsSns^ the liata associated wtfb the 
dtseoyeryURL's cmmm of registered busiiwssEntity irifdrmafion. To seared for URt 
without regard k> useType attribute vaiui^. pass the useType component the 
dti^ovefyURl eiKoents as em^y attributes. If useTv^ values are induded. the 
match wli be made only on registered infomiatidn that match boSi the useType and URL 
vaiue. The returned buslnessUst contains businessinfo structures matching any of the 
URL's passed {iogice! OR), 

Returns: 

This function i Rtu'n?. 5 businessList on ?Lrce"i ■! e e\ e' 't tt-^at no rnatr.nfis were jocsted fof th-D 
spectfied cntena, a businessljst structure w«h zero businessinfo structures is returned. 

In tne event ut ^ iat«jc nLi^D,--r 5- Jr^r-jr-. ^.f<= mav ti-unc^iifc the result set i'n^ix 

occurs, the bUi>:ni:S5L sst w ,■■ '-.ca- \.i - s-e :■ /- r?.-;: - nlnbiite \v!th {he v<3lue sai to tue. 

Searctiing using ti\4odesBag vwil also rettim any businessEnttty that cofjlasns bindif.gTsmp!ate 
infom^afion that matches due to hostingRedtrector references. In other words, the buanessEntfty 

JUNSJS,20t(2 PA0E1? 
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that contains a bindingTempiate with a hostingRedirQctorvaiue refersnctng a bindingTempiatethaJ 
matches the IMadel search requiremeitts wil! be returned. 

Caveats; 

if sp.y etror occurs in procea^iing tf-iis j-^sessage, a disposstionReport structure wiii be returned to the 
caller in s SOAP Fsull The foliowtig error number in^Dr^■T^ton wif! be F^e\'ant: 

« E„fsameTooLonQ: stgnifies that the partial name vatus passed exceeds the maximym 
rsame iength design^ed by the Operator Site. 

* E JooS«anyOptions: $igniS^ that more than one seansh argument was passed. 

• S^wnsupportsd: signifies that one of the fihdQualifief values passed veas invalid. 
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The M service message returns a servtceList message that matches the condfbons specified m 
th© arguments. 

Syntax: 

xml ns="um; !iddt-ofg;api" > 
i<finaQuaMiersi>] 

^name/i* i<categori«ag/> ! <tModeSBagi«> 
<^!nd_sen?tce> 

Arguments -^h nvTic c-t---" ^ \? ' A > n^nts are mutualiy exc'ustve 

« msx-RoiVS Tl- IS ' ^ t , t s'iPc progj^ri ff> > m " ihe >-iunber 

of restJits returneci: 

• businsssKey J-- ^ -^Vu . B.-(ne'5<^Fnt;. ti->t.)! c< 

behavior of searcJ->'ur^c.{iona!ity St-e the Sc » Osai ef^.. pu\,.> for ntor- ip.oT-^st on 

» «ame Thts stnng value rep-^nts a partsri n < Any t u^tntssS«i v tre Or contained 
tn »ie ^lecified busnessEnttty v«8i amatc^fng partiat -amc vaiut? getfc rsUrred 

• cst^tiryBag THs fs a Itst of cMagoty references The re^Tsed servtceUst contaf^s 
businessfnfo ^dunss matching aJ! of the categories passed (io^jicai AND) 

• ^otfefSag; Thfs is a ftst of t^od^ uutdjtey values that reprint the tecnntcai Tngetprint 
to locate v^mn a btndfngTemj:«at8 Stucture contained vwthfn any bustne^^Ss^ice 
contaned by the businessEnfety specrfled if more than one tModef key ts speafied in tht^ 
stf udum. oniy bu^nessSeivtces that cawtain bindtngTempiate mfomi^on that matches ait 
pf 8ia tyod^ keys specf^ed V¥fli be returned (fogical AND) 

Returns; 

This fundson retuTis a servfcebst on success in the event ^at no matches were located for the 
spsqfied catena, the; servtc^Ust ^rut^ure retumiad contain m empty busihessSefvices 
structure, This signifies jsere matches. 

in the even of a large number of matdies, an Oper^or Site may truncate the rssuit set if thfs 
occurs, the semceUst wi! contam the tmnGSt&d attnfaute wth the value of thfs attnbute set to tnm 

Se-a'-ch.ng uy, ig tr ItxjeiB-ai vw retu - ss! ' elr'o ^fuct^w f )! a!' c j=5!ffs,iri, bt -,uesho'.' o: ^iaia 
ncucii g naic os d to ho"^tfogRec . \r '■ef-re'^efr !n cfher vcict ti„ ! ui^inessLnity 
A'no5>o buswe-^^-vev 's passed as ar argument contains a btPQingTemplate with a 
hosti.^gRedir<='c*r vak.e. and that value references a bfndtnglemplate that matches the tModel 
searc, . r j!f f^menb ihen the semcelnib for the busanessServfce oontamtng the hostmgRedtrector 
vwfi be returned. 
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if any error occurs in processing thfs message, a djspo^tlonReport structure wB returned to the 
caiter in a SOAP Fauff. The foilovwng esror number ififormation wjB be ref^ant 

* E„!nv3!tdKsyPsssed. signffies ihat the uaidjit^y vafue passed did not match with any 
known buESinessKey key or tMoifel key values. The error sti-ucture wiil signify wtiich 
conciitson: occurred first, 

« E_nam8TooL£>«g: sigritfles thai she partia! nanis value passed sxcesds the maximum 
name length cie:ygnaf:ed by the OoeratarSite. 

» £JooM3nyOpt!Oi-is- ^^igniHss t'-gt --o^-e -v^r- om rr^uiuBlh exclusive argiiment wbs 
passed. 

» E_unsupf>ort8d. signifies that one of the findOuaiiSer vgiues passed \m& invalid. 
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This f}nd._tMociel message is for locating a list of tModel entries mat match a set of specific cnteria 
The ressjonse v«!l be a list Off abbreviated fnfcsmaSon about tModels that match the cnteria 

(tMocieiList). 

Syntax: 

<f!nd.JModei ga'ner!C~''W { maxRvws^''m'' ] xmlns="um:uddf-org:api"* > 
<rtafne/> ! <tdentjn^ag/> j <GategoryBag/> 

Arguments: The arguments to this cal! are mutuaiSy exclusive except find Qua lifters 

« maxRows: Th\B opttonri! irj&ge- V8!i;e alkv.v? the requesting program to iimit the number 
of results retus-ned 

» findQuamers- Tm co ie-::;;: ci ' ^..^v iie^ eierr.snts can be used to alter ibe de-fault 
Def-.avior of search hioct- -cji '\ Soe Search Oijahfitrn; 3pper;dfx ^or m< ir^; it .foar!,-;t(on 

♦ name; This string vstue reptesenss a partial name. The returned iModelUsi contains 
tMtxjetlnfo structures for biMnssses whofse name matdies the value passed {leftmost 
matdi). 

p mnmsrB^: This is a list tjf business idehfifier r^ensnees. The retamed tModelUst 
contains tiWod^lnfostTLS^uresmafeNng any the ietentifieis passed (idgii(^ OR). 

» mtsgmyBsm '^^s is a list of cafegory refereoces. The returned tWodelU^ csdr^aim 
tModeiiofo stmcturesmatcHng a!! of the categories p^sed (logiea! AfsID). 

Returns: 

This fundjon returns & tModelUst on success. In the 8v©it that no matches were located for the 
specif ed critetia, an empty tModeiUst stoicture will be returned (e.g. v«li contain zero tModsltnfo 
structures). This signifies zeftJ m^ches. 

ill the ever! of a large number of matches, an Operator Sfe may truncate the result set. If this 
occurs , ihe iModetU^ w^ll contain the fwflc^ed attribute vs4th the value of this attribute set to ttm: 

Caveats: 

if any error occiir.'j in processing this i-iessage s asspositionRepoft structure vwll be returned to the 
easier in a SOAP Fault The foilowng error n^rriber infoi-n-isfion vwill be relevant 

• E_r!DmcTooLong: Signifies lY\al the partial name value passed exceeds the maximum 
name length designated by the Operator Sii&, 

» EjoofVSanyOptions: signtftss that more than one mufuaiiy exdusive argumant was 

passed. 

* E„unsupfiot1ed; signifies that one of the flndQualifier values passed vwas invalid. 
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Ths get„bindingDetail message is for reques^ng fhe rijn-ttme bindingTemf^ate ir^ormafion location 
Infonrnatioo for the purjjose of invoking a registered business API 

Syntax: 

<get_,bfndingOetaH g©nenc="10" 5<mlns="um;udd!-8it(:apr > 

i<hmngKeyI> 
</get„btndfngD8tai!> 

Arguments: 

» bmdingKey one or more uMJ(ey values that represent specific instances of known 
isindingTempfate data. 

Behavior; 

in genersk it is recommended that bincfirigTemptaJe inforrriStion bs cj-.^vxi locoily by r-:ppitCv5t!ons 
so that repeated caflsto a ser^jics dssonbed fcy a bindingTempiate cat', be nuxi-.- i^'v-ihou; ha\-.r>Q to 
make repeated round trips to an UDD! regtstr/. In the event mat a cat! made v/tJh cached data 
fafs, the 9et„btndtngDetai! message can be used to get fresh bindingTemptate data This is usefei 
in cases sue^i as a service you are using reioeating to anotier server or being restored in a disaster 
recovery site. 

This function returns a bindingDetai! message on succes^uf match of one or rrtot^ fcsndingKey 
values. If muitipls bindingKey values were passed, me results wiii be returned in {he same order 
as the i<eys passed. 

in the even of a large nwiber of ms^clm, an Opemtor Sjfe may ttyncate the result set. if this 
OGCurs. the WndirigDetaii result will oontain me Jroncatec? attribute with 8ie v^ue Siis attrtbufe set 
to trm. 

Caveat^: 

!f any error occurs In processing «iis mes^ge, a disposESonReport stnjcture v«SI be returned to the 
caiter in a SOAP Fault. The foiiowing ermr number inlbmtatton w!l be relevant; 

* E...inv3!{dKeyPassed-. signirlss that one of the auid_key va!ue.n passeci did not match vjm 
any i<nown bindingKey key values. No partial results wai! be returned - if any bindingKey 
values passed are not valid bindingKey values, this emsr will be returned. 
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"^^8 get^businessDetaf! message returns compile biiSinessEtiJijy iJifomafeon for me ot 'noso 
specified bustnessEntitys. 

Syntax: 

<geKbusfrTessDetsil genef?c=s"1;Q" ){mfns='uni:tjddi-or§;spr> 

1 <bustnessKey/> ..,] 
->/get_fousinessDetaffc> 

Arguments: 

« biJsmessKey . one or more uukt__f^y values that tBpresent speahc instances of known 
busine&sEntrty data. 

Returns: 

This function rflurns; a businessDefeif mes^ge on successful m^di of one or mom businessKey 
value? if muiiiplc busfnessKey values were passed, tte res».j!ts wifi im returned in the same order 

as the keys passed, 

in the sve'-' of n lajgo n. Mx^ .V. . S'fe may tamcafe the rssuit set. if th'S 

occurs, the businessDeSa,! responss n-.ssfxjye contain the fmncetetf atttibuie with the vaije of 
tfjis attribute set Wtaie. 

Caveats: 

ff any error occurs in processing message, a dispositionReport structurs vvii! be returned to the 
eailer in a SOAP Fat^t The foBovsfing error number infomiation wiSi be reievant: 

• e JovalidKeyP8s«ed; agnizes that om of tne uuid_k&y values passed did noi match witJi 
any krtov^ businessKey values. No partial results wl! be j^umed - if any businessKey 
values passed am not valid, this error vwfi be mtumed 



COP'VRSGHT 2000-2002 8Y ARtBA, iMC, iMTg«NATtO«Al, iJUSitJFSS MACHiNES CO«PGRATtGN 
AND fo«CROSOf-"f CORPOSATiON. 



get . busme^DetailExt 



The get„businessDetai!E)rt message retums extended businessEntity infofmafion for one or more 
speciftsd businessEn^tys, Th's message returns exadJy the saroe infomiation as the 
gel^businessDetail message, but may contemn addilionai at&ibutes if ths source is an externa! 
registry {not an Op0ratQr Site) that is compatible mth this API spedfication. 

Syntax: 

<get busi n essOetaiExi Qei->eiic=''i .0" xmlns="ijm:uc!dt-org;api" > 

<bt.i3inessKey/> 

( ^busfnessKey/:> . . .] 
</get_^businessDeta)l£xt> 

Argufnentsr 

• busfmssKBy : one or more uutd^key valu^ that mpmsent j^eoific instances of knovw 
feusinessEftftJy data. 

Returns: 

TTsis function returns a businessDetsiiSxt message oo successful match of one or more 
busSnessKey vatues. !f mu!6pie bu^nessKey values were passed, the results be mtt^ned in 
the same ofxier 3® the keys passed 

in the even pf s lercfe nurnber of matches an OpsrafOf S^e may tjurvcate th6 re^^jft set; If this 
poeors, the bu$fne^DetS(f Ext response message vwil ccintain the fn/rtcstecf mmiM ym the vaiue 
of this aftribute set to trm. 

Sav«&ats: 

if any error occurs in processing this messsge. a di^SionReport strucfum wil! be returned to the 
caBer in a SOAF Fault The foiiowing entjr number inffsmatjon m be rdevant 

• SJnvaisdKeyPassect: si'grefies that one of the uofoL/fey values passed did not matoh with 
any known bUj^nessKey values. No partiai results wrfJ! be n^umed - if any bu^nessKey 
vaiues passed are not valtdi this error be returned. 

• E_unsuppo>1ed i:r<^^'is that the ^ripiemenlslion Queried does not support the extended 
detaii TLiPa jr;. ;f -nss occurs, oussnessDetaii infofmaSon shouid be queried via the 
get^businessQetat! APi. Operator Sites vjili not return this code, but vwff instead return a 
bu^nessDetailSxt imiit withlult buisinassDe^^ informatldn embedded. 
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The get_„servfceDetaf! message is used to request fu!i mformaSion about a ktxjwn fx^-itncs^o^tv vx 
structure. 

Syritax: 

'-get se-XT'sceDeta i 0c/Tenc»°1.O'>tti'>!m="um;uddi-Qrg:ap)''> 

<sea')ceKiSy.*> 

</get ,sefViceDefat}> 
Arguments: 

• seivheKey : one or more uMJ(ey values 8iat represent specific insiances of known 
JbusinessSetvtce data< 

Returns: 

^ ■ o ^\,MOf=. >n -eiun-s a setvtceDefef! message on sucoessfuf match of one or mom serviceKey 
^ Oil hnt !)). --i sr;n.'fcsKey vatfues were passed, the results vs^i! be tBtumed in the same oixief as 

this keys Dassea. 

in the e.'en of a Sarge . - ^P' -ato -sy fjn. cite ir..-' fCbul! seJ !Mhis 

occurs, 1{>e response cuofa n a t'uncatba «ttnoots wsh Jhe vaiue of this ^Unbute set to trm 

Caveats: 

if any efrGroGOffs in pnocsssing this message, a dispositionReport stf uctum wll be rstumed to the 
oali^ in aSGAP Faufl The foBovtrfng ermr nurnijer information vviii be r^evartf: 

* ejnvalidKeyPas^ed; signifies that or>& of the UMfcTfey values passed dfd not match with 
any known servtceKey vaiues. ivJo parda! results wiii returned - If any sefviceKey 
values passed are not valid, this eiror will be returned 
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The get„tMode!Det8i} message is used to request fa! informaiion aboi^ a known model strudurs 
Syntax: 

■^getlModejDetaii ge«e«c=:"l.O"' Kmfnsr!"um;uddi-ofg:8pt''> 

<tMddeiKey/> 

r<tMod^Key/> . 
</g8UMddfelDetaH> 

Argume«ts: 

♦ tModelKey : one or more URN qualified uiMctJisy vaiues that represent i^jecific ini^ances 
of known {Modei data. Ati tModeiKey values bsgirj wth a uuid URN quaiiiler {e.g. "mid " 
foifowed by a known tModei UU!D value.) 

Returns; 

This funcUon returns a tModelOetaS message on successfui match of om or more fModelKey 
values, ff muttipie tMod^Key vafues were passed, the results wJif be returned in the same order as 

the keys paased. 

in the even of a iarge number of matches, an Operator Site may truncate the resuit set. if this 
occurs, ihe responss Vvii! contain a tnincsie(i attribute with the vaiue of this attribute set to true. 

Caveats: 

if aoyerror £»?curs in propessif^g fhfs: message, a <ii§positk)nReport stoure vwii be mtumed to the 
suiter iri a SOAP Fadl llie foiiewirig error numijerinfomiatfor) wiff be rdevant 

* £ JnvaKdKeyPasseci: sigrjiSes that one of the URN qusiiSed uuidjiey values passed did 
not with any knowrt {MociefKey values. No partial results ^]\ be returned ~ if any 
tModelKey values passed are not valid, this error vwi! be returned. Any fiVJodelKey vaJues 
pBsmi vi^thdota uuid URN quaiifier wiii be eonsidered frsvaiid, 

• E_i<;eyRet|reei: ^griiSes that the requeSE cannot be satisned because the owner has 
retired the MxSel infofmation. The tModel reference may sSi! be valid and used as 
intendeci, but theinformaRor^ defining fiie tyodel behind the key Is uh^ailabie. 
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ess to an UDOi 

ct triiiiaffy sefect one Op0rator $it0 to host their information. 
Once chosen, information can only be updated at the site ariginaJiy selected. 

The mssssges cefined in this section alt behave synchronously and am csilafate via HTTP-POST 
oniy. HTTPS is ussd sxdusveiyfor ait of the caffe defined in this publishers API. 

Hie publishing APi calls are: 



deletejiVfode! Used to delete registered mfwrntion altjout a tModel. n there are anv 
references to a iModei when this c^B is made, the tModet wili be maii<ed deleted instead 

of being physicaily removed. 

discard_authToken: Used to infoim an Operator SitQ that a prevfousiy provided 
authentication token is no longer veitd. See get_authToken, 



3 to use ali other APi's defined in the p 
m equivalent of a Icsgin n 



ssve„bindfng; Used to register new fairtdingTempfate infomaiion or upd 

tjindingTernpSatg infomiation. Use this to controi information aiaout technical capabilities 
exposed by a registered business. 




Special co«sideratio»is around c^e^dzation 



Several of the APfs defined in this section aflowyou to save rategorizstson infomiaiion mat is ui,ed 
to support searches that use taxonomy references. These am ojnenWy ihe save business, 
save ..service and save„.JMoci6i APIs. Categorization is specffied using an optionai eletTi'ent nsnned 
catesoiySag, which contains namespace-quatified r^er^ces to taxonomy keys and desciiptions 
iri i<eyedRsfe.»'ence struc'ures. 

Dafa containsd iri tins ksyyalu® atthbute of each keyecfReference is validated aqatrjst the 
taxonomy referenced by Ihe as.-socfated tModeiKey, Only vaiici keyVaiues wi! be storeri a"? entered. 
Operslor SUbs may iiartciie inyalfd keyVatues by eimerfail the raqi.H5s{ or changing the tModeiKsy 
value to reference an non-validated '-etc."' iaxonomy whidt accepts ail keyVaiuss. See Appendix H 
for details on the validation of taxontsrtic infcffmafion. if the Operator Site ctiooses to fgii 
categorization mechanisms, the error oodes defined in appendix H wtif bB passed {jac!< as the error 
code on 8ie rdwant AR calls. 



TtTe d6tete_b?ncfirig message cau^s one or more biodihgTemplatg to be deleted. 
Syntax: 

<deii;t(> Dind^ng c.!fc/ter(^^-'1 0">im!ns="iirn;udds-arg:api»> 

<auiii:!n:fo/> 

<.deletejDtndtas> 
Argurtjsnts: 

• aothttifo: this ret?utred argument is an element that cwtains an authentication token, 
AuthmtfcatiGo 1d<er« are (Gained using the get„authTdken API call. 

• hhidtpgmy : cm or rnors My/sLAey values to ts^resent ^etfic instances of knovwi 
bindtngTempi^edata. 

Returns- 

Upon successful completion, a di^sitt^iReport is returtied Virfth a ^ngle success indicator 
Gaveais; 

If any error occurs m processing this message, a dIspostttonReport stnjcture wli be mtumed to the 
eaaer in a SOAP Fault The toJlowing error number information will be r^ievanf 

• EJnvaiidKsyPassed; sgnsfies that one of the >juid_key v^^iues passed did not match with 
any kmwn bindingKey values. No partial results be returned - if any bindngKey 
values passed are not vaild, this error wiil bis retufTisd 

» E_authTokenE>cpirod: signifies that the 3uthef)tica&on token value passed in the authlnfo 
argument is no longer valid because ifje token has expfnsd 
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E^authTokenRequrred; signifies that 8ie authen&atiof> token value passed in m 
authinio argument is either mls^ng or is not vi^id 

E^userMismatch: signifies that or)e or more of th& bindingKey values passed refers to 
data n~m is not rontrofled by the individual vMo is represented by the atjhentfcstton token. 

e„operatorftSismatch; signifies that one or more of the bindingKey vsSues passed refers 
to data that is not contrdEed by the Operator S^e that received the request for processing. 
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mas as 



The delete busioess message fs used to rsmowe one or more buslnessEntHy structures. 

Syntax: 

<^deiete .business gsnetic-'-i.Q'' xrTiin5-"um:uddi-org;api" > 

<authtnfDj> 

<btisinessKey/5< 

[ <bLJS!nes$t<ey7> ..,] 
</de!ete bustness> 

* sufhlnfo: this required 8;gu;T;,-^t ar. e:eni--rd ira; cor^iains an isutheniicattW token. 
Auihisntiaition tokens are obtaineci using (he 9ei_auth}"okef) API caii. 

* busitiessKey : one or more mkl_kBy vaEues ths* reppesen* ^ecifrc Instances of kmm 
businessEntity data. 

Returns: 

Upon successfut compieSon. a dfspositionReport is returned witi a single success indicator,. 
Caveats; 

if any etror ocairs in processing mfs fnessage, a dfSi»sj«dnReport stwcSure will be returned to me 
calterin a SOAP F&iM. TTie foiio^ang errcir nmibaf InfomiaSon will iae n^evant: 

» EJnvaifdKfeyPsssed; signifies thai one of tiTe i/t/«3f„feey values passed did not match with 
any known buslnessKey vafues. No partia! resufts will be returned - if any businessKey 
v^uea pas^ are not valid, this sfmr vtfill be returned. 

* E_authTokenExfiired: signifies tiiat tfie aythenticaSdn token value pas^d in the airthinfo 
atgument is no longer vaSd because the toiten has expired. 

» E_authTokenReejuimd: signifies mat ttie authenScatiOTi tof<en vaiue passed In the 

authSnfo argument is eiliiei- missing or is not vaiid, 

» E_userfiSismatch; signifies that one Of mors of" the busine,^sKsy values passed refers to 
data tiiat is not controiied by the irHividua! wt^o represe-f^tec; !:iy the authecitication toiten, 

* E„operatoriy5ism3tch: s!;:inr;e<, cr;o of f^:ore of li^e b-isinessKey values passed refers 
to data fitet is not controlted by the Operator Site that received the request for processing. 
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delete service 



ihc delete &2tviC8 message )s used to remove one or moe bustnessServfce stnjdures 

Syntax: 

-'dpSeto^service '7eienc="1 crxmlns="um-u(idk3(^apt"> 

<auih!nfo/> 

I <s8!ViceKey/> ...] 
'-/dtJiete services* 

Arguments: 

* i^uthfnfb I'vh n^qunea gri,tintent ib eleriient th^i cor>{3!ni> an authentication tofesn. 
Authcnj 3i'Q' i t, F arj- obtained ustng t>ie geLauthToken AP! cafi 

• setviveKi / . - . Ttore auid^key values Siet nspresent specsftc instances of known 

businessSeMce date . 

Returns; 

UDon sucGsssfu! cwnfrfetson, a dt^osttionReport ts miumed wth a isin^e siiccsas indicator. 
Caveats: 

if any enor occuts in pracesso^g ih-? messoo - i ^ ^ <. ' po t - i>x.c * wili be returned ?o t?»8 
cafler in a SOAP Faiit The foHowng erior nunder tnfo-j-nstior w! be rrfcv -it 

o EJnvaSciKeyFassed sgnities that one of ^e um^JeyvQiue- ^ ab-^ed a ^ s o. - with 
any know* setvlceKey values. No pattiaf resufts"wti be reiunida ~ f any serviceKey 
values passed are notvaiid, this errar wil! be returned. 

« E„authTQkerigxpJr«cl: sfgntSes ttat the authentication token v^ue passed h the authlf#o 
argunTent is no longer vaitd because the token has ©cpired. 

* E^authTokenRetjulrsd sgnffiea that the au«ien^caS)on token vafue passed m tie 
authinfo argument is either rntssang or is not valid. 

• fc;„user!V?ismatch -^igntfios &iat one or moie of the servtceKey values passed refers to 
a^U n 'i! - ml copt-n eci by the I'ldfyidual v/to is reprinted by the aut"ient-c;mnn tOKen, 

» E_opera^oriVS'<5mat:ch aiij * es. t^at one ot 'nore of the service <ev v^Ik js, pa&sca --eferS 
to data tnai is ngt controlled by the Opomtar Site that received ttie tequest for processing. 
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ilie delete jMode! message is used 
syntax; 

<deiete„tMQdel generic?" 1 .QP xm!ns=^urn;uddf-org:apf" > 
<auth!nfo/> 

<tModeif<ey/> [ <tMoc!8lKey^ „ ,] 
</(fefete„fMi3de!> 

Arguments: 

• autiftnfQ: this requtfed argument is an element contains an authentication tdken. 
Aumentication tdcem are obtained u^ng the get^aothTbkerj API call. 

» modelKey : one or more URN q jaiifisd WJ/cL^rey vafues that represent ^sedfic instances 
of knovw tModel data. All tModetKey values begin wth a uuid URN qualifier (e.g. "uuid:" 
fdiowed by a knowi iiviodel UUiiD vafue.) 

Returns: 

ijpon stjccessful ctrnpletfon, 8 disposi^onRepOftis^m^ a single success indicator; 

Sshavior; 

if a tModel is deleted and any oti^er fitansged data referor!v,^< ■ I:iy '/;y/d.. ■•-:>■ (e.g. 

within a cstegorySag, iderrfifisfBag or \vftiifn a tModeitnstsnc-.if <;) ■■■.■< A r.oi Ik- j)hvycally 
deleted as a result of tnis tali. Instead !i will be m3r!<ed 5$ ! iio'd x;n As :v tModfjio f iid Jers k\ \hs way 
are stfil accessible to their owner, via the getjegisterediriVj bui -mW ix; on^iiied fr:<ni sny 
returned by caiis to itndJiWlodet. The details associated with a hidden tModel are stiii 3v;i ijnle to 
anyorje 8iat uses 8ie geTj^^odelDetail message. PubiisNng parties that want to remove lu-^tis; 
about e tiWodel fccsn the system shoufd calf ^veJModel, passing emF% values in the d<na u^i^K 
before caifing this function. A hidden tModet can be restomd and made universaiiy vtsbie by 
invot<ing tiie save JModel API at a later tinrje, passing the key of the hidden tModel. 

Caveats: 

if any error occurs in proces^ng fiiis message, a dispoationRepoft structure will be returned to the 
caBer in a SOAP Fautt, The foiiovs^ng error number information v»SII be relevant 

« £ JnvaSidKeyPsssed signifies ii-iat one of the URN qualified uuid _ key values passed did 
not ■Tiatcfi with any kr^ov-^i tModeiKey values. No partial results wli bs rstutr;sd - if any 
tModetKey values passed are not valid. thi.<s error witt be retijfnec!. Any iModeiKey values 
passed wthout a uuid URN qualifier wti! be considered invaiid. 

« £..authTokenExpired. signifies tl^at the ajtiientitt^tion token value passed in the authinfc 
argurnert is no ioncwr valid because ffie toker: has expired. 

» E„authTo!<enRequired. ^Jgrifias t-icit the auihent-cation token value passed in tlie 
authlrifo aRjument »s either missing or is not valid, 

» E_us6H«t$match; signifies that one or me^e of the tiVlodelKey values passed refers to 
data that is not controlled by the individual who is represented by the authentication token. 
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E^pfssmtojiafemateh: sfgnlfies^^^^^ more of the iMocteiKey vaiues passed refers 
to dsrta that fs rrot cootrdteci by t{>e GjeemforSfe tjat recsivscS the requ#for proq^ng. 
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The d)scard_authToksn message is used to inform an Operator Site that the aumsn^oation toksn 
can be cfiscardeti. Subsequent calls that use the same ai^hToken may be rejected. This, message 
is optional for Operator Sites that do not manage session state or ^at do not support the 
get. authToken message. 

Syntax; 

<d(Scard„aut!iIoNer! gemrldr^W xnilnss''umiuddi-:0rg:api'* > 
</disGard„autoTok6p> 

Arguments: 

" suthtnfo: this require argument is an eiement that contains an authentication token. 
Authentieatiorj tokens are ot^airjed using the get^aufliToken API call. 

Returns; 

Upon successfui completion, a OispositionRepon is returned wth a mvA& success in.:5icator. 
Discarding an expired authloken wiil be processed and reported as a success condition . 

Jf ^ny error occur? Jn processins this mes^ge, a di^sttionReport structure will be returned to ttie 
callsrin a SQAP Fault. Thefi^foii^ng^r number infotmafionvwil be r^evant; 

• E„8MtiiTofesnRe{|uir«cl: sfgrtiies 9iat the aOttisntSoation fejken yaSue pa^ed in the 
auttiinfo argyment is eitiTer missing or is not valid. 
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The geLauthToken message is used to obtain an a 
opaque vsifues \hst are mqutred for aS! j^her oubJish 

Opf/rato; S-tes th<-5t have an e 
This AP! is provided for it 



Syntax: 

<gst„£t'th Token genenc^'"i,^ xi 
</getatithTot 



userfD; this required attribute argun^eni is the user thai an indMdua! authorized user vvss 
assigned by an Opsmtor sm. Operstar sm m each provide a way for individuais to 
obtain a Userlp and password that wili be valid onily at the gtven Operstof Site 



This function returns sfi authT<3kif>nnsssasfe that contains s veiki authinfo 
used in ^bsequent <^jteid pybitsher AR redtiiman atifhf«fovai.i« 



ortstrMto«*ii!be 



signifies ti^ fhe Operator Site that received Ihe re<ju?st does not 




n elament that Gontatos an ay 
9 the get„authTol«eti AP{ da!!; 



Upon successfui corfipisiiof-., a resissteredinfo 
bu^ness informatian >n one or more DusiDesslr 
more tModeJJnfo structures. This API is usefijf for 
infotmatton control!eci by s single user m $ sing!e cat!. 



stpjoture wii! be rstumed. listing < 



in proces^ng this mssssge, a c^sposifortReporf sSmctum vwi} be returned to the 



calter irt a SOAP Fault The following ermr 



srinfomtationwfifbew 



E„««thTDl 



* token vaJue passed in the 



The save^bindng message is used to save or update a conipiete dinciingTempiate stnjctui e i hfs 
rms&agQ asn be used to add or update one or more bfndingTeropiate stmctures fo oi>e or more 
■?;<f5tina businessSefvice structures. 

Syntax; 

<$ave. binaing gen8nc^'"\ ,0" xmtf>s=''um;ije{df-ot5:apt" > 
<auth!nfo/> 

<btndirjgTempl3ie/> HbirtdfngT^p^ate/!*;. .} 
</save_b{nding> 

Arguments: 

« authinfb. this requ red ar,^u"ieri „s .-.sr- eie:r^?-? !f-.at cc^iiasns an 3Ulhent:cation token. 
Authenticafon tokens are obtained using r!-;e get aufhToken API ca!i, 

* bindit)grm}plst& ons or more com^^ete ixntitp-gTernpiate structiires. The order in it^ftch 
these aw processed is m defined. To save a ne^JV bindifigTempfate. pass a 
bindingT^pJete strqirftjre an empty bindtngK^y attribute vafe 

BBhavi&r: 

Each bindtngTen-tpiats structure passed must conte-i h >w>r;'ircK^'v vaiue -h,,! .\'i^rpsr.onds ;o a 
regii^red businessSewice cof#o!!ed by the same pe^.-v ■■ ^ oy.«fvj th«- b^ndtr-o i<.nu>:^s{e data The 
net effect of iHs cat! is to estaWi^ *e per* - s x'^sSe-.''^ rshti, for each 

ijindinglempiste affected by this cait, if ttie same tsndsng fernpiate (derermiiied by matching 
bindingKey vatue) is fisted mom tiian once, any r^afonship to the containing bustnessService wii 
be determined by processfng order, which-is detefWined by the position of the brndir^oTsmpiate 
data in first to fa^ ORien 

Using tilts message it is possibie to mosfe m ^istir^ bindtngTetrspiate ^cture frm\ one 
businessService structure to ancrfh®^ by ^m^y specg^fir^g a different parent businessServfce 
relationship. Changing a parent refationship In ttiis way wil! cause tm businessService strucKjres 
to be afferted- 

if a foindingTempi^e being saved contains a tiostingRedirector element, and that aiement 
references a bindingTemF^ate that itseif contains a hostingRedirector element, an ermr condition 
(EJnvaifdKeyPe^d) witt be generated. 

Returns: 

Tht? Apt rsJurns a bmdingDeteii mes^ge containing the final results ot the caii that reflgcts the 
newi V f^Kjistered infofm^on for the effected t^ndlngTempiate structures. 

Caveats; 



if «nv t'-ror occurs tn ptoces.>!ng t-. ? ^^5^.,^. .^.-.r^oo;: struduj^ wfii be returned to the 

calier in g SOAP F,nult The fotfow;r.o rr.nir.er .-.-'orvf^a-or, v^iii !-e reievant 

• E..autiiToker^Expired signifies that tn*; aumsnSicatJor. token vaiue passed in the authlnfo 
argument !S no !ongervi^)d because the toi(en has expired 
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* E„authTokertR«quired agnjfles that the authentioatton token vaUe passed m th© 
authlnfo argument fs either mi^ng oris not vattd. 

• E„keyR6t(rcd stgnfies that the request cannot b© satisPed because one ot more 
uuid^key vsiaeb ^ea^ed nas previously been hfdden or rotrsoved bv the re^quester This 
specificaBy appites to the tMociefKey vgtues oassed 

» SjnvahdKeyfassed ygf-ifte'^; f-ia* *"<^ "nu<=st ^^rnot be s^tts-fi dbf.^ jse one or more 
ui/'c? ^ev values, spoctfi'sc^ s 'v-^t r- d Scs ^'a!up n! «h,5* ^ lost -aR. d't^ctof value 
ref'srenc c h n J pg'^^n'- - < - ^'^-tain--. is hosfir< director v -a ue 

re of the tjuid k&yvalms pas^d refers to data 

5 represe>fted by the asihentication token. 

oata tr 1^ not u>'i!ro led Dy rhe O/m .^mr b,(c ihat reca v od thfe i oquest f^r arocesstrg 
£^?sec>uotUmi«Ej£€aBe<^«tf: siQhitSe^ that user acmiht timjts have b^en exceeded. 



E^userSvlfsmatch 
that s ' 
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The save„business message is used to save or update tnfomiation about a complete 
businessEntity structure, Tbis AR has the broadest scope of afi of the save^x APi celts m t^e 
pubfisher APf, and can be used to make sweeping changes to the pubissheci infomiation for one ot 
more businessEntity stwctures cor^tnoHed by an individjaf. 

Syntax: 

<save_business genenc^'"\ ,.0" xmins="urn;uddf-org:apii" > 
^auth!nfD/> 

<.Dj<; -e'^.sEnf h/'> [<bus<r>essEsitity/^, . .] ! <uf^eac}Registen'> [<up5oadRegtster/>, ] 
</save„busfn8ss> 

Argurmnts: 

0 1'y opf tyoe of businos^Fntrtv c" - ^ . t " h ' --r^ may he passec sr. h ! ver 

s?is.'e business nessage AnynufH, * - s.Doadj^ecsiers'al j' < '.=!Tk 5 ^s^sa 

iji d sipg e save ^up to ar Ooe"'<-'; ^ ^ " fv"w^iN>> of s if H^f^ 
should not be mixed. 

• sffUifnib this required argument an eemeif t^isif <.on{ nn-. a .-ui'ienicat o'j wKen 
Authentication tokens are obtained using the get„suthToken APi cail 

• bus^ne^EM^ one or more complete busnsssEntity structures can be passed These 
stnjcturesGan N obtamed in advance by using the geLtJuan^Detaii API csli orby shy 
o&ser means. 

• i/pfosrfi?effe<er/oneormor®resdvabieHTTPURLaddfessesmatea^ 

and vafid buansssEntity or tsusinessEntttyBd stodure Thfs vanant argument aiiows a 
regfstiy to be updated to reflect the eontehts of an mL doeiifnent that is URL 
addi^ssabie. The URl must return a pure XML t^mertt on^ cof^taihs a 
bu^essEntiiy ^cfejre as He top^ievd ei^snt, and be accessible using the standtSfd 
HTTP-GET protbCQt. 

Behavior: 

^uy -) I.U J^ c jsk ^ ivif-in ir a iiu&inefc.&Cnt>tv strurtur» tea --p, cfdta »nh 3 Kev 'aue 
r(xj icjf^ ib\ ^ busin-sbKty NetvictjV'Y bfndinQi<6y st tMocJt K"'^'! •^ jn-^se^' -5 ! ! "i^ \"!Lje 
f'li'- 1 a siqn?' r-at the oata {na !j> ,r K^jed beinq insw-rfpii T\ n, ot e-- •^ppi', to Mr k ures 
tni '■tfs^'-^nie '^th'^'^ c /eci data s tV'^c' IK(^/ e<=e'iaes= iithtr bu ''■nQ'"^''iip!ate or 

i^eyedReterence structures, sincs these are referfinces. 

Tvi pTiko his function peifow an ufXiatc to existing isgistered uata the keyed enttsto 
(bustfjessEntity businessService, DtndmgTeiTis^ate or tModel) should have uuid key values that 
Gorns^iicl to the registefed data. 

Data van o-^ -Jeie^ed wth t'-is funrtior \ u < ^t^p ^jjfferent than ths new 

if^OfTiatjon i^rc. a"d Orje or more t --qTempiate structure that are 

found in tne crntrotimg Ope'Sto' Site but a - - c ^ 'lessEntity tn^on-iat o'ovioed 

m or referenced by this ca>i vwil be defeted * - . ^ a ; r to a s ' « { jjs 

Data that is contained vwthin one or more busine^^sEniity can be fcasf ingec vvi,h ♦his fancf o't « lit, , 
data passed to thts funetton redefines patent container reiatonships fot othu registered 
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(n.orrriation :'0! instance, if a new bustnessEntfty is saved with tnfomiation about a 
bu:5!r:essS^;i^'tcft that is regisferect a)ready as part of a separate businsssEnttty. this wiff result in the 
businessSer>/,ce beiiig moved frf»ni its current container to the new businessEnttty. This only 
appites If {he ssrp.e party controis the data referenced. 

If the upioatjReqlPter URL method is used to save data, the Operator Sfe is required to make sure 
that ihe URL i;fed ^^K'viec: in the dsscoveryURLs collection within ttse businessBititv staictum. 
K tm URL pas?e:! to Jo tn- up ■.-so' is ncft contsined in this coSectton. it wi!! be added automaticaify 
witri a useType v h^.o sv; L^ v-.e sypss of structure {either buanes$Entity or busfnessEntityExt) found 

in Vr,ii iiig used to peno.-r:-; ;re urio,"d 

If the file located by (he upiosdR-^;:^;.^^ :,iue is an exterided business ent-tv 

{busfnessEnfityExt) structure, only the iXisr;-s^£rt:r, data found v^thin t^^at stmclure wt!f be 



ff the bustnessEntay method is use<t to save data (e.g not via en UDfoadRecistsr s JR{ lefererioe) 
then the QperstorSit^ will create a URL that is specific to the Operaior Srfe thaf can oe used to get 
(vi^ H f rP-GET) the bustnessEntity structure being registered. This infotTnaiion vvtii be added to fif 
not present already) She dfscovsfyURLs collection automaticslty m\h a useTypa value 



Returns; 



TNs APi returns a bustnessOetai! message containing the fihaf results of the caii tfiai mfiects the 
new registered intormsSion for th© busfnessEnti^ informatjoh pttMdM 

Caveats; 

If any errof^occurs in procervSfR'^ this message, a disposttionReport sfaicture will foe returned to the 
caiie;' HI a bOAP Fault 1 r.e 'c'iO'-'-.nn ofn^r 'ii,r>-iix-;r information wiif be relevant; 

• E„autt}TokenExpired- ?ign ? es ihat ire .suthenticatSon tc!l<sn value passed in the authlr^o 
argument is no longer vaifd because tj-ie token has expired. 

' aih^*'*^^^''''^^'^"'^^'^ 5-J'>''o-o t-at the auft^entication token value passed in the 

• H_keyR8tired, agnffies ti^Ji tt^e request cannot be satisfied because one or more 
uuid_,H0y values specified has previously been hidden or removed by ttie requester. This 
specifically applies to the ttSddeiKSy vatijas passed. 

• EJnvafliJKeyPassed: ^gnlfies that the request cannot be satisfied beca^jse one or more 
uuicLkey values specified is not a valid key vafue. This indudes any tModeiKsy 
references that am unknown; 

• £jwatidURtf»a$seti: signifies that an error occurred with one of the uploadRegister 
URLvaiues- 

• E_use»fassmatchr signifies that one or moro of the uuid key vaiuts passed rcsfers to data 
that Is not controlled by the individual who is tiepfesented 'by the authenticatto;-: loKe-n. 

» E_opemtoriWismatdi : signifies that one or more eg the businessKev vniues passed refers 
to data that is not controlled by the Operator Sfto that received the request for processing. 



ANa sWlCeOSOi- rCGRPORATtOM, 
ALL SfGHTS ??fJSEf?X'SD, 



* ejnvafidCategory (20000): signifies that the given ksyValue did mi correspond to a 
category within {he taxonomy iderttifieci by a tModetKey value wthin one of the 
categoryBaci Elements provided 

* E_cstegorte;jt!onNotA«owed (20100: RestrtcJions: have bsen placed by the taxonomy 
provider on ins types of inlormation that shouid be inc(ud-3d at that iocs^ai-. vvithtn a 
specific iaxonorny. The validaUon ruuSine chojsen by the Opemior SKe has rejecteti this 
businessEntity for at least ona sptic '-.en C5i:j;;:.yv 

* e^accountLtm^xceeded: sigrvifsys ^at user account itmits have been exceeded. 
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The save_setvice mes^ge acsas or updates one or more SusinessServicestafCiur&s. 

Syntax: 

<save service g©r?er/c='*1,0''xmin&="um:uddf-org;api"> 

<au{hmio!> 

<bijsinessService/> [<bus!nessS6rv(Ce/>.,.3 
</save_serviGe> 

Arguments: 

• aa*f>/nfo: tNs required at^ument ts an dement that contsf'ns an auther^icatiofi token. 
AuSienttcafion Mens are oistairted u^nglhe ggtauthToken API mi 

• buslnessSen^m: one or more com{^ete businessService stnjtSuj^ can be passed. 
These strictures can fc© obtah^ecf in advance fey using tjs get servfceBetail API ceit or by 
any otter means; 

B0havior: 

Each businsssServfce structure passed must contein s biisiness;Key value that corresponds to a 
fegi^edsd busirtessEntity conirolled by ^ same makir-g fhs save service requs^,. if the same 
businessService, or wtNn these, trfridSngTanpiate (determiRed by'matching businassSsrvice or 
bindlfjgKey value) is cor^dried in more than one businessSeMce argumenf . anv rylniionship to the 
coDtatning businessEntity wiH be determined by processing order - ^^f■^ch is determined by fitst to 
last order of the irjfomiafen passed In the request. Using this message ii t$ possibie to move an 
existing bindingTsmpiate struc^re fnro me businessService sfedure to another, or move an 
existing businessSerx^ice structure from one businessEntfiy to another by simpiy spafcin^ng a 
different parent businessEntity retationship. Changing a parent reiationship in this my wf! cause 
two busit>essEn% staictures to be affet^sd. 

Returns: 

This APf returns 3 servfceOetasi message containing the M Jesuits of the cat! that r lects the 
nevvsy rsgtsterad tnformaftort for the ^ected busfnessSemce structures 

Caveats; 

if any erroi oocurs -t p.x-y;^ ^■^i- i . o^e-vs- <^ ^ -,Sih.p{.- { onRepm ^nuddfc m\\ bi '■A ned to ih*: 
caltermaSOAPF-jJ -^r— j r f.foirndi or A'sif b( re'e ari 

• E„autiiTokenExpired ■> v Butreni •-^^ ir toKe .a'jo rc^-e<. in {-e tino 

» F_authTok8nRequ!re{i < < > ^^Aft^^jor oken v-sh p .>spd it i^c 

duthinfoangiifii<.r ^ < ^ 

' e„keyRetirBd sicntfies tr^at the request cannot he srtf^^ied because cr^ or ^-ae 
uuid_Hey values speoPed *wb previously been hidden or removed by the '•squ^ster Tt>s 
i^eciff ca^fy applies to the iModetKey vaiuss passed. 



^>^^i:,n,2oa^ ^^^^^ 

mo MfCROSOPT GORPO.WfOR 
ALL SIGHTS SJESSRvea 



• jnvahdKeyPassed: signifies mat the request cannot be satisfied because one or mom 
uakfj:ey values specified is not a vafid key vaiue. This fnciudes any tModeiKey 
references tiiat are unknown, 

• E_usefM}smatch; signifies tfist one or more of the uoid^key values passed refers to data 
that is not coniroifed isy the individual who is represented"i>y the authentication token. 

• E_operator1W(smatdN: signifies th&t one or more of the uu!d_k0y values passed refers to 
data that is rxjt contrdted by the Opemior Site that receivsd the request for processing. 

• SJnvaiSdCategory (20000): signifies mat a KeyValue did not correspond to a category 
Within the taxonomy fdantiljed by thetModefKey ir^ the catagoryBag data provided. 

• E„catsgorizat}pf»?totA!towed {20100: The ta)fohoniy validation ratine dioseo by the 
O^^torSiJe has rejeGted the busfnessServtoe date p^^ 

• e^acco«^^^mjfS)cceet3e^^^s^9n{{!es m^^^ account iirtitfe hav^ b^n exceeded. 



The^eJModei message adds or updates dhe or tModei stnjcsums, 

<save JMDdel )^erte/fc=f"1 .0" xm!ns="um:«ddj-as;apr > 
<authft>fo/> 

<itModei./> [<t!Vfodei/>...] i <!jp)oadRegfster,'> j:<up{oadRagi^r^.,.] 

'-iiiiwe tMode{> 

Arguments; 



* suthlnfo: this required argument Is an element that cmtains an auSientication toi<en. 
Authentication tokens are obtained uangthe get_authTok6n API ceil, 

* modBi-. one or more comfrfete {f»^odei structures can be passed. !f adding a nm tS^odel 
the tModeiKey vaiue should be passed as an empty siement. 

* uphadRBgister. one or mory resoK'^jae HTTP URL addresses that each point to a single 
and valid iModet stnjcture. This vs-^srA argument allows a registry to be updated to reflect 
the contents of an XML document thai --i URL addressable. The URL must return a pure 
XML dacLimsnt that only contains a tModei stnjcture as its top-ievs! elerrient and be 
accessiible using the standard HTTP-GET protocol. 

Behavior; 



if any of the uuid^key values wthin in a tiVtodei structure (e.g, fIViodefKey) is passed with a blank 
value, 8iis is a sgha! that the data is being insert^^ 

To make thisfuncSon peifomt as^ updaiB to existing registered data, Ihe tModeiKey vaiu<=js r-houfd 
have iiuidj&y vaiues that coirespond to the registered data. Ail tModelKey values ihst are nor,- 
bfank are formatted as urn values (e.g. the ciwacters "uuid:" precede aii UUiD values for 
tModelKey vaiues) 
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!f a tModelKey value Is passed that Gorrespdrsds to a tJVfodei that was p^viously hkJden via the 
cfeieteJWipde! message, the mm m be tie restoraiiorK:* ihe tl^csSsi fe fuii vftsiJality awaiiaWe 
retyfT! in fjnd^.tMcKjel resMjte^j^^ 

Returns: 

This AP! returns a tfc^odelDeM message containing the fina! results of the cali that fd^eds the new 
registereci informaSoo forthe effected tMcde! strucfUTBs, 

Caveats; 

!1 eny en-of occdcs in processing this message, a dtsposltionReport structure v«8 be returned to the 
csHer in a SOAP Fauit, The fo!toY-/!ng error number information wfff be relevant; 

» E_atjthToker!Expired: signffies that the authentica^on token vaiue passed in tiie authinfo 

argument is no longer valid Dec^iuse sne toi';en has expired. 

» e„3uthTok«nRequired- a-in^fe^ s:-:© auihentica^on token value passed in the 

authinfo argument is Sithei- rrussing ar is no! vatid. 

» E_keyRetir)gd: ;^:Cii-it;8s= 'hat ihe ^or^tjosf csniioi be S3tis-?fe^d because one cr more 
'juid_k&y values syecifte^i has-- ;.;!<.:v 0:;&iy beerj hiciden or ren-^-oved by the requester. Thfs 
specilically applies to the trvlD(i'-;iK;?> vo'ises passed. 

» E JnvalfdKeyFassed; signifies {hat the request cannot be satisfied because one or more 
MJ«sf„)<ey values spscHled is not a valid key value. This vwfl occur it a uukijioy vaiue is 
passed in a fiViodel that does not match iwim any knovwn tMode! key. 

• EJnvsMUflLPassed; an error ooJUffed wth one of the uptoadRegtsier URL values. 

• E„used«ismaich: signife that one or more of the uuklj<ey values passed refers to data 
tiat Isnot osntrdfed byths tndfvidua! vt^o Is represented by tfte ai^tertficatien toi<erv< 

• E„opera&>»l»jsfTjat<*t; signffies that one or me»e of me ya/(l./feyva}uei5 jS8Ssed refers to 
data fiiat is not ajrSroBed by the OpemorSste that received the request for processing, 

» E_SwaltdCatsgory: signifies that the given keyVaiue did not con-espond to a category 
■vvittiir! the taxonomy identified by a tiViodetKey vaiue within one of the categoryBag 

eieniente provided. 

» E . cstegorixationNotAiiovv-ed i-^estrk^ons have been placed by the taxonomy provider 
ti""*' \i ' ' . ^ ^3t should be fnduded at that iocatrcsn vwthsn a specific 
ta-^fonom^ ri-.e zavo^. rjjime chosen iaty the OpemtarSits has rejected this fModel for 
at least one specified category, 

• EjsccQunttjmi^xceedecl: signifies that user account iimiis have been exceeded. 
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gm>r Codes 



Tho foiiowlng i'^^ of error codes -.a i :->e '.jt:.n:-c r:g «nno values within a dispo^tianReport 
response to the AP! chilis defined in this i}tog'arrm&f& reference. The descriptions in this section 
a'-e gsrserai and when used with the specffic retu^-n 'nfornotton defmed in the indivldua! API cail 
tiescnptfons are usefu! for detemiiofrig riie reason forfaiiut^s. 

• E„3uthTekene)q>ired: (10110) signifies that the authentication token information has 
fimsdout 

• S„au«iTokenRequtred: (10120) signfSes that an invalid authsnticatton token was passed 
to an APi c^i that requires authentic^on> 

• E„accoun«L{mftexceed«d; (10t60) signifies thai a save request exceeded the quantity 
iimiis for a given structure type. See "Strudum Umits" in /^ndix D for detaiis. 

• E J>usy; (10-100) signifies that tie request cannot be pfocessed af the current tfme; 

• g„catesonzatiot»NotA!!ow6d: (2010O) Restrictions have been piaced by the on *e types 
of infomiaSpri that cart categonzed within a specie taxohomy. The data provfcfed does 
not confpnm to the restficbons placed on the category used Usmi with cafegorfzation oniy. 

* SJataiEnror (195QD) signities msX a ^rious feehnicgS en-or has: occurred mie 
pxjcessing the requ^t, 

* £,jnx;ai{dKsyPassed; (10210) signifies that m& uuid„key value passed did not matci^ 
With afiy knovvT! ksy values. The details on the invaJid key wiii be induded in the 

dtsposi tionReport stnjdure. 

« EJr^vaiSdCategory (20000): stgrmies that the rjlv^n keyVaius did not corrsspond to 8 
category wttnin the t.3xonty-^.y Isent-Mt:} by tne iModelKos . \ JSKd vjtfi 'cinn?3t(on only, 

* EJiwagtiUm.Passed; (10220) signifies thai an error occurred during processing of a 
save funcfion involving acces-sifig daia from a remote URL. Ti-ie deiaiis cA \h>: HTTP Get 
report be indudad in the OisposittonRepoft structure, 

• E„!<eyR8tired; (103 JO) signifies that a uui(fji0y v^u& passed has been removed from 
the registry. Whiie the }<ey was once vsdid as an accessor, and is sfili possibiy valid, the 
publisher has removed the information r^erenced by the uukfjasy passed, 

* EJanguageSiTor; (10060) agntfies that an error was detected v>*itie procesang elements 
that were annotated with xml:lang quaiifiars. Presently, only the descripison element 
supports xml-.iang quallfiacations. 

* E_nameTooLong; (1{3020) signifies that the partial name veiue passed sxceecs the 
maximuni name lersgth designated by the policy of an impfementatjon or Operator Sits. 

* E_aperatori^fsmatch: (10130) signifies th&t an attempt was made to use 8i8 publishing 
.APi to change data that is mastered at another Operstot Site, This error is only retsvant to 
ifse pubiie Opemtor Sites and does not apply to other UDDl compatii^e registries. 
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E„succsss: {0} Signifies no faiiufe occurred. This return code is usad with the 
dispositionReport for reporting resuits from requests with no naturai re^onse documerji 

EJoolWanyOptions: (10030) signifies that incompatSbfs arguments were passed. 

E„unrecagnfeedVers!on: (10040> signilies that the vaiue of the gweric attribute passed 
is unsupported by ihe Op&r&tor Imtanm biaing queried, 

g„un5<nownUssr: (10160) si^ifies that the user {0 and password pair passed in a 
geLatithTpten message jsnot kmwn to the OpersfofSfe or is not v^id. 

£_unsuppefteti: (10050) agnizes that the imFderrsenter does not support a feature or APi. 

E^iiserMisfysatch: (10140) sSgntSesthal an a8empt was made to use the publishing AP! 
io Change data that fs a3f#o«ed by another party. In certain cases, E operatodVJismatch 
takes precederjce fn reporfing an error. 



Errors that are not reported by way of SOAP Faults are reported .UsfnQ the dispositionReport 
. structure. T Us structure can be used to signal success for asynchronous requests as weii. 

Success Reporting with the dispositionReport struqlure 



The general fostn ofia success rspott is: 

<7x(t-\ ver^.lon="1.0'> 8XJcacSiiig=»UTF-S" 7> 

<Scdy> ' " ' '■■^^■■'■■■^^ "-'^ -'^^ s,^^c..ope/ 

^dispositioGRsport generic--^ .0" opera!:or-«0per3j:c;rUrl " 
;,x(nXnsK "urn:uddi-org:apt " v 
<resuifc erxiio:^c " o " > 

<«rrInfo errCode.->"S success.;" /> 
</rssttit> 

</8edy> 
</Ei3Vfis.l:ope> 

Eritir reporting wiih the dispositionReport structure 

At! appiication errors are commurscated via the use of the SOAP FAULT structure. The genera? 
fofTTi of an error r^xirt Is; 

<7:<V-'{ ve-, -".'1 "1 ' '— : 

-43s;dy> 
<Fauit> 

<tacit code >Ci lent.',/ tauitcQde> 

<f ault strxrxg>Cllerit Exxor</ f aiiitstring> 
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<detail> 

<disposition8.«porfc generic- " l . G operators "Oper^storUrS " 
xsraiJ s « um : iJddi^org;ap! » > 
<rssuit «rrnos"100S0" > 

.:err2nf o srrCode= "S^notSxjppojrfcad" > 

Ths findQuaiifier value passed isp sarafe cognised. 
</©rrI»£o> 
/results 
< / ctisposi tionSeport?- 
</fJetaii> 
<!fmn> 
</8ody> 
<^/Etive)op8> 

MLiiflpie ff-s-u/f .■riemanfs, may be prese-iJ ■ - cj ii.,-i, !/.,nReport staiduse, tmci can be used to 
provide ven/ aetsiieci en-or reports for muifcpse enor aondiaons. The aumber of msu/i efemems 
relumed vwthin a disposifton report is twplefTiarjfegon specie, !n general it is permissiSSie to return 
an error response as soon as the first etror m a mques* is detected. 
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This appendix covers the SOPP spedfe conveniens and requirements for Operator Ste. 
$*ip|»»rt for SOAf*ActiQ.n 

hver^-io- < v< SOAPAw'j- ^ leiJe- , - ^=i>.s8d in this HTTP Header 

'Djst ,j'> -M f5> iu mo >• ir ot nded by doco'e qiiote!> hxaroplc 

POST /get B:-,nc!.iriqDetsia HTTP/i.X 

in versron 1 of the UDDi specification the SO^ Actor feature ts not supported. Operator SHmyf^W 
reject any reque^ tiiat amves vwm a SOAP /tefeji' attribute- 

in version 1 of the UDDt specification the SOAP ei-coJiog bature (secoon 5) is not suppetted, 
Op^for Sit&s vit meca any request ihst arrive sMth a SOAP encoding aUril5Uts. 

SOAP Fautt sppiies Vivien unknovm AP! references invcted, ete. Apoiegate spedfic errors wii! be 
hsndied via ttie dfsposttSfjnRepert AP! vwtiiin SOAP Faiiiit structures (see appendix A). The 
fdfowing SOAP fautt codes are used: 

* Ver^onMjsmatch An ifwaiid namespace reference for the SOAP envelope ^®«ent was 
psssed, The valid r^mespaee vafue ts 'Mp://wvw.xmisoap-ojg/soap/envdope/'^ 

• MustUnderstand A SOAP header efOTsnt passed to an Op&ratQr me. Operator 
S(fe<i CO not support any SOAP headers and vwi! return thfs error vi*ieiiever a SOAP 
request is recefved that contains any Headers element 

« CSient A r^iessage vvas fnoonnectJy formed or did not contain enougti informafen to 
ixjrfofrn mt>re exhaustive emsr reporting. 

S«pp«*t fbr SOAF Headers 

in vetsio- 1 3f the UDD! ^pecffca'ior SOAt' hs^o&i, >,ro not s( ->pv<io6, Ooerakw Shes are 
nernitt^c \> in e i head" Mpr< -a SOAP '"-a lers i . hc'v c he must„under$tsi^d altnbute 

Oociwsewt encodms c«si¥e8^SQ«s - ^mSk namespace support 

Or^orM r s„^=s ar^- rtxiJtrcQ to -^i^ipot thp use oi the derautt ra-iiespaces in SOAP rsqufe^ and 
response documents as shown in the fdiowing HTTP exarripie- 
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<Bcxiy> 

<get._bi nd ingOeta :i 1 generi C'^ « 3. , O" 

tlW-^ to Unlcotle; SOAP SIstSHer behavior 

rne decision to u.^.e iHe UTf-? ■-r><..cd-"g n 3i| requests simsjiified ihe riymber of encoding 
vanatfon? thni f>->ed to he -anrjiei wtn^r; ih-s XML IntercJx^nges ust^O h-. this API specificatioa 
Hovv^=v&r. i>yfe onJoting .sr;d Cv;r'Vv--<=.!0-i is^-ues sUII srise. This se<;fiOii descrs&es behsvior 
of the SOAP listeners thaf .Lsn Oor-.vfo-- :>,.'cs ;;-> recsardi, tr -he tf^-y ijonvert data received 
into XfvJL encoded tn !..!ntco<.is. 

UTF-8 allows data to \:se trafismftted ^v^th an oyi^-jnoi uveK-.,;.;-;::;.:-: i.yfw onfer niBri.; jBOM) 
prececHng the XML data. This BOM does f-'Ot o-.i.nbn ;riorfn.r;ion *ha; .s- usoftij i'or ciscnding me 
contents, but teflsthe ret^tving program the oroer {hm hyies wiil^in ciou'ols.s byte pytrs o:;cijr witriin 
the data. Further analysis can then be performed to determine vvtieti^er ihe XML received contsins 
ASCI! Of fJnfCQcJe ehsrseters. The BOM is not fequlred to parfofm this analysis hO¥*/©ver, and S is 
safe for OperatarS^0sm remove tie BOM prior to processrtg messages received, 

Pp&mtor Sites must be prepared to acx;iept messages mat Dcmtein Byte Order Marks, but the 80M 
is nuA required to pro<^ss SOAP messages successfuffy, 

■ Data retwned by ail of the messages denned in mis specification will not contain a BOM, and v^ill 
l>e encoded as UTF-S XNffL data. 
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Appendix Cs XMt Usage Details 



TWs appendix explains the specifics of mt conventims employecJ across all UDDI Operator 
Sii0s. fmplementa8oriS that desire to remain compliant mfh the behaviors of Operator Sites sliouid 
fdiow these same eowenfens. 

Wse or muitl;>ie lansit^ges lit the (SeseHjjtkm «Jeme«4s. 

Many of the messages defined in this programmers interface ^jedfication contain an etement 
named descei/Min, MulSpie descriptions are allowed to aecommodate multipie ianguage 
desciiDfions. These descrip^on giements are also pennitted to be sent without an KmUang 

attribute quaiif'ter. 

Oniy one descnptior. element is aiiox,ved to be passed to a save xx Apt cai! vwthout an xm!:larig 
sfinbuie quaiifser. Eiements passed in this my mW bs assigned the default language code of the 
registering party. This default ianguags code is established at the Sme that pubti^ing credenfiats 
are established with an iridfViduaS Operator Sfe. 

If n'.ore th=in on?.- descnptton element is sent in a document being stored, only tfie fii^ descripto 
eier-nent in s p^itt cuidr structure may be sent vwthout a xm!;!ang a^bute qualifier. All sjbsequam 
descnption peers must contain an ymlimg qualifier. 

The vaTtd values for language coctes are to be speBatie<J as ISO iangaags codes. Values for these 
i^des and transfation to c^6r <^fnon language code^^^^^ be found it 

Oniy of^e descnstion element !s aliowed for each iangiiage code used at anv givsn container 
level. 

A de^? Jt ISO 'angurfq^ 'x* .!„^'- ^ L ■sher.st {ime 'he a pari, establishes 

permissions to ojofish at s s,wej ; Oj'-.k .'■S'c^-n^, ; e-jt? tion '^-^ <^ <.i^i?..A 'angjage ^Jd^ M 
oe applied to my descnptior^ values that are pros, tdeJ wit> > no langu^oe a idc 

On data netumed vo 8ie SOAP mterface, als descnptions wi' contain xmt 'ang quaisficattsns 

ISSUE tor V»tWa«lo«j X«ll. names|»ae« ^«etamtlon 

Fcsf use with the xni!;lang language quatttiers. documenfe that cjontaih tt^s atttlbute wall declare the 
xm! namespace as: 

This wl! occur at the top lev^ of the instance document (in the Envelope element) 
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A!! messages to and from the Operator Site shaH be eixoded using the UTf -B encouit^g, and all 
such messages shal! have the 'sncodings-UTF-g"" atiibute on the tmtia! line. Other encoding 
r>ame variants, such as UTF8, UTF„8, sfc. shaB not be used. Therefore, to be exfrfictt. the inftia! 
itne shall be: 
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Appendix D: SecuHty mofiei in the publishers API 



1 he Pubfishers AFi descslbes the messages that are used to controi the content contained mthm 
m Operatic Ste. and can iae used by compiiant non-opa^tor implemef^ations that adhere to the 
behavio-s descnbed in this programmers rsfemnce specication. 

Achieves wire level prfvacjr: Mi mefltocte are seeu««d via SSL 

• At! calls made to Operator Sites that use tiie merges defined in the publishers APi wff! be 
transported using SSL encryption. Op&^tor Sites mil each provide a service deschptiorj tiai 
exposes a bindfngTempiate that makes use of HHPS and SSL to secure the tran^tsaon of data. 

Each of the catis in the pulStshere APi mat change information at s given Operator Site requires the 
use Gf an opaque authsntscaSon toicen. These tokens are generated by or provided by esch 
Operate," Site independently, and are passed from the cate to me Opemtor Sk& in the elen^ent 
named aiithinfo. 

These tokens are rjieamogfu! only to she Go^^fBiar Sfle that prcwtdsd them and are to be used 
acoording to the pijbtish-Jd yolictes of niven Opc-'fo' Sits 

t?3cii party ^J.'ho has l>errn grantees punucatior accK^s to a gtven Operator S/fa vwi! be provided a 
token by the site. Obtaining tfxs token is Operstor Site speciiic. 

Bef.)?« any party cosn oobhan rials \\nh\r> <jo CVs'-i/c- ^:.■^t^ crenontsais and permission to public 
fri'.f^: bf. a^f^)bi!J;tK5d wt". the indiv!ciL,,ji .^pc-Jto- GC'-e-aiy, >o,j \vi:i only need to mterad wth one 
Oi!(-i.Ho' S;tf becdu?e a!i data pu£>iii..'-;f;vi <it a"> Opi!)r}tQ>' S/te iS repitcated automatically to 
r>thp; On'.r:t-it Siies E?r:3i5iishing pubi.'sJ'iing creasnhais invdves providing sotne venfiabie 
fOt.;'itrii f.si;Qn !fiforrr,3tion, cantart tnfofrn-iiion and esTabhshtng security creaentta's wth the 
individual Opi?raror Site. The specffics of thess establishing credentials is Opsmtor Sits 
dependant, and all valid Opemtor Sites will provide a Wet>-based user intetface via whicti to 
estabtish an idenf^ and secure pemitsstons to putjiiish data. 

AMthentlcattOfs tokem am not portabte 

Every- registr/ impiemeotstion that adheres to these specifications vAll establish thetr own 
rvischanssm for totcen genera^on and authenticc^on. The only requirement niacea o-.', tokeii 
i^eneratfon for use with the pubiishets APf is 8iat the toteng themselves musi' he vahc; ^inng leyt 
that car. be pfaoed within authlnfo XML eiemeni Given that binafy to stnng iransiatioris are 
wetf undefjstood and in eommon use, this mqufremeht wt! not Jn^-oduce hardshipsr 

Authentication tokens are not required to be vafid isxcepi at the OpBmtar S^& or impiementation 
ftorrt Miich they fjriginated. These toicens need only have rneatling at a sfngie Operator Site or 
fmplementatjon, and Ml not be expected to vfotk esams sites, 

Se«eratt«g A«a*e»ticatfeo Tokens 

Many imptementatjons are expected to require a login step. The get. authToKen message fs 
provided to accommodate those imptar^entations that desire a login step. Security schemes that 

AiHSJS,2t>t<2 PAC-ES2 
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are based on the convention of exchanging Use- c.l :;=?n\:>rj i.n:'denttais fail into this 
category For impJementattons thai destra this kir-; j< 5,0 . y - . jst authi oken API is provided 
as an opfional means for generating 3 temporat-y sul^-ieniiCfStion token 

Certificate based atith^ticatton and simHar secunty mechanisms do not reqtttse lino ado,tion?t step 
of "logging \rf and can direcfiy pass a>mpatfb)e authentication token fr^fofT^■^a^op (sucr as a 
cergficate vaiue) within the authlnfo eJement prtwided on eacli of tiie publishers AR messages if 
cerTfcate based authentlcaljon or simitar security is employed by the choice dl a given Operator 
- S<fe, the use of tiie getjaySfTokenand sfiscardjauthTok^ messajges is opSohal, 

Per^swcownt Sfiace limits 

Onoraior Siws may impose iimsts on the amount of data that can be pubfished by a given user. 

The fni«a! mits ior 3 new user are; 

» busfnessEnfety: 1 per user account 
• bu^nessServfce: 4 per bustnessEnt^^ 
« bifjdinglem plate: 2 perbustnessSetvicS: 
« tMcdei, 10 per user account 
tnd«/tdua! user accounts can negotiate per-^count limits vyiUi tfje OperaforS/fe. 
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ApuendixE: Search Quaiifiei^ 



li<e qqt i'y AP, imciions, hnd b,nct>nq and httsincss Ond^semce, and fi^d tModot each m\ 
accept optional elefvjent named findQuaitf ers, 1 hh elem&nt argument ts Dfovfdod as a means 
to allow 5he cssllerlo overnde ciefauit seatTcfi behavjors. 

GeKsral form of ssareft tiwalifiers 

The genera! fom> of IheMQuaiifisrs strucSuns is: 



The vaiue passed in eseh flrtdQuafto dement mpresents me behavior ehanga desired by 8ie 
cailer^ These values mtffii cOTe me fdlow 

» exactNameSSatch; signifies that feffrnost name maidi b^avior shouis} ise werridden 
When thfs behavior ts ^3oafied< only entnes that ®<acify match the entrv passeo in the 
name argumenft wii! be retuirted- 

* -saeeSsntfvsMatch: ^grsfies th^ 8ie default case^sensi^ve behavior csf s oame match 
should be Qvemdden. Wheo ihis behavior is ^jated, case fs reievarit; In Sts search 
result* ?-d oniy pntnes that match Uie case of ihe value passed in tiie name ai^umsnt m\\ 

be retumsct. 

* sortByfviameAsc sn^'fies th3f ti-ie rc^uit returned by a find^x or pst^ mqmry cat! ^ufd 
be sorted on tn nor it fieid ir ^<^"<r! c tg aiphabetic sort order Th's sort fS appited prior to 
ani trurc=5tion of eiault $i 's Or- > r'^DlscaNe on cjuene<5 that return a name element in the 
tonTiO":* cf-^{r I k >.c M ^ r ^ { ry.i \ ^ co'if ictmr so?t oualiile'' is speced this is the 
fitf ' t <- "^ev'aht. 3' thts cornctet oetafi eve 

« sortBy'^JaneDesc $» ' ■^'yH^iid >c ^y-^^/ v nqi f^' c^sli ->h'5u!d 

ht Hd o" a € larte -< ohphetic <^or{ o ':it-r 1> boti tspitNed prtor 

io-^ns f^jn^ation o re^ i ^ uc^hte -in qm= ne- that rei-un 5 ^ifj* eismeit!'- 

the^o'T d-W 0-^1 s SiL-tberf ^rsoofnec f< uw-ir ooet o ihfs 

kind Of result. 

• sortByDateAsc ;>uf-'-s *i- ih-<' '( qJi tetu-ned by •( x t ' inqo ri, d 
Shoutd De sorted ha<^eJ on tie .al^ u>t « i n ^,aMifnr hf i"io(,^i-o -^oi ^rce'- 
(eariiestreti!m<itir<?t. if no oonlv. ^^Ss^to^a « ^%x'^m<o hf- is iht Jc a jII sort orce' 
fcs^ result sets Sod qualifiers nvo'ving date ate &e^,ordafy n precec^nce to *hi 
softByName qualiers. This causes sortByName dements to be sorted within name by 
date, ddest to newest. 

• softByt>ateDesc (dPfaiUt^ stgn«ftes th-jt the r^^^ut »e!u'ncd ov ? '"'n^ a or gpf > n-|L 
call should t>e sorted bas<="i u-i tf^e date fast ufxiarpo r d->s 0,'^^ rh ori^ioqra! =y~-t 
order {most recent cnange ffiumh Irst) Sort qualifiers if^volving date are se^o^'^^!■y ,! 
precedence to the softSy Name qualrfiert, This causes. sortByi^ame eien'vents fo be softed 
wMhin name by date, ddest to newest. 
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At iHs time, these are the only quaHfiefs defined Opetatar Sitss may define more search quailfier 
vafyes thah these ~ but StW Operator Sites and fuBy compatiWe software must support these 
quaSSfiefs and tjehaviors: 

Precedence of search quafSSers, when combined is as folfows; 

1. exactN^neRSatdh, caseSensftSveMatch: These car* be combined mt sre equal in 
pr©ce<Sence. 

2. soitByNameAsc, sortByNameDesc; These are mutuaily exdusfve. but equaf in 
prececiencs. 

3. softByDatsAsc, sormyDateDescr These are muttiaily exdu^ve, but equai in 
precedence. 

The precedence otxier is used to detenrsm© the proper ordering of results v^^en muSipte search 
qualifiers are connbined. 



The US English ^E{^„US):!osa!e shaB lae used v*efjev6r a stmg cxsnparfson or afphabefie sort is 
Rifled; This applies to SGrtByi^iameAsG.sortSyNan^ exactNameiyiafch. 
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Api>endix F: Resiionse message reference 



Here we explain each erf the response messages. These are iechnicaJiy defined in the UODf APf 
schema: 

• authToken: This strsjctun? is rstufn by the optional get^authloken message to r^um 
authentication informatton. The value r«*jmed is used in subsequent cafis tlnat reqtJira an 
authinfo value. 

» bindingDetat!: This structure is the fej;hnicei iniorrDation required to make a method caii 
to an adver^sed web service, it is returned in response; to the get^bindingDetaii message. 

• busJn«ssOete8; This structure contains fufi detals for zero or more businessEntity 
stnjctures. !t is returned in response to a gatJjusinessDetait message, and optionaiiy in 
response to tiie save^business message. 

• busirtessDetailExt: This s&ucture atiows UDD! comp8m>ie registries to define and share 
extended irrformatipn atx)i^ a businessSnttty. Qpe/a<cr S/fe« support this message but 
return no gddiSpna! data This s*\icture! contains zero or more businessEntifyExt 
structures, ft is returned in response to a get.bu^n8ssC3eta(fExt message. 

« businesslJst This stnicftif^- contains abbreviated information about registered 
Di.fSint•}s•^E^tity (nfo>;-->atj^>r; ^ his message contains zero or more businessfnfo structures. 

it t^; returned in response to ;;i T!nd_busfness message. 

« dispos!tlor«Repo!l Tiiis stsur.tufe is used to repcn the outcome qt message procsssing 
and to report eftors dsscovefgd during processing. This message contains o.ne or more 
msyt structures. A ^Jectai case - success - contains only one result stnic&js^ \Mlh the 
special emio atWbute value of E^success {0). 

• regtsteredirifb: This staicture contains abbreviate.^ ;rjfo;rr.;ition about all registerecl 
bUSinessEnSty and tMode! information that sre coriiroittd by tl^c fx-irtv s-p'iofied in tne 
request. This massage contains one or more bi-isinysslnio sirt-auf-is and zero or iiioie 
tModaiinfo structures, it is returned m response to a get^registeredirtfo iviessaqe 

• servicfeDetait; Ttjis staiCture contains futi details tor 2ero or mors busSnessService 
structures. It is returned in response to a get_sen/iceOetail mess^e, and optionaiiy in 
response to the save^fcMnding and S8ve„$efv{i^: messages, 

• servieeUst: This sfructure contains abbreviated infomiaSon about registered 
businessSen/iee fnformsjjpn. This message contains zero or more senricetnfo stmcfijres. 
It is returned in resfxinse to a find_.servtce message. 

• tModelDetan: This structure cont^hs fui! details for Kero or more tModel structurea It is 
returned in rtsspof\se to a getJft^odeiD^ai! messes, and optionally in response to the 

save tModeffnessage, 

• tiVtodeftJst-, Thip structure contairfe abbreviated information about registered tVbdei 

tnfofmation. This me3.sage Gontams zsm or more tModeilnfo stR-ctures. it is fBtumed in 
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sn-jl* i^jiiff of 3xrcnce -n; detei-i^ n "g \ tancct loca'tcr V ^#ni s > s < ss S'-r . co rciue^t {o 
a remote web service in Q«>!ieiai Ifo ^.t -*fO'or of a D^rt j-i- '.-.^j , r bindirr 7 e'ipiate 
structure can be assured that by keeping me registered ccoy »rjii^t*no io. the proper" server or 
invocaiion address, special conditions sucfj es disaster 'sccvery t j -i seco.'-sdar,' sits can be 
handled with a minimum service disruption for custofrsers psrinsrs Ths; sgrtie hoids true for 
those who choose to use a regisby that is ctmpaSWe with the UDDi APi, b^jt to e lesser dsgree, 

fn many cases, the AP! spedfied in the get_hind}ngOetai! message is straightfoward. Once s 
business or apr^tcatiori knows of a service that needs to be invoked, the bindingTenipfste 
infcifrnation for this service can be cached until needed. !n the event that the cached information 
feiis 3t tm tjme the partner web sefvfce is acttialiy invoiced (e.g. the accs^Point M{»maSon in the 
cached btndingTemplate stwcKJre is used to invoke a remote partner service}, the appiicafion can 
use the bindingKey in the cached irrformaSon to get a fresh copy of tiie bindingTemf^ate 
information. This cached approach serves to prevent needless round trips to the registry. 

slt«atsor?s re«|«idtie the hostlngKedimdor 

T'wc special needs arise ihat cannot be oirsctiy supported by the acces^oint ififoortation in a 

bindinglempiate. Tfjese are: 

8 Third P^^rty Hosting of Ts>c!-inic.^i VVob Services: A businsss chooses k) expose s 
serx'ice that ii^ actuaiiy ho-^ie■.-^ ;.i ■o\r]:<i'^ or third parfy s'te. Appiicstion SsfVice Providers 
anc NaWor!'. i\'1ari-;et Make-s .:;:v; c o^^';x;^ fsxempies of this situation, in tnis situation, it is 
the actual third party that needs to controi the sctuai value of Ihe binding infom-jStlon- 

« L/se speciilc access contro! 50 binding iocation; Ir^ c.iiie; i<tuta{:on&, sqjoh j^s situation 
spedftc ETedirecdon based on the identity of the caiier, or e'vsn time-of-day routing, it is 
neGessaiy to provide the actual contact point inlbrmation for the remote s^ce in a more 
dynamfc way than the cached acce^oint data would support. 

For these cases, the bindinglempiate stro-^b-.-es contain an aitemative data eSerr-ier:! caiied 
hostingRsdifBCtor The presence of a hDst:rigRe<;:rec!C'r elemeni is mutuaiiy exciitsive witj-i the 
acces^oint infojinaSon, This maSces it possibie to tett wfsich method of gaining the actua! 
btndingTempiate information that contains the accsssPoint data to use. 

Uslrtg the Nostir)9{%eciimc<»rdata 



When a birjdingT^piate netumed by UDDi registry contains a tiasiingRediiector eiemenl, tiie 
programmsf uses this informafion to locate the actual bindingTemf^ate for the i^osted ser\'!c.e. The 
content of the hostingRedirector dement is a bindir^Key reference that refers to another 
bSndingTempiate that conteins tiie addmss of a reditiector service that wiii respond to a 
get^bindingDetail message. The argument ttiat gets passed to this message is the oriqinal 
bifKSingTempfate uofeL^fey value for the mdireded sewlce. The bindingTempfate t^turned by this 
redirected caii must have a accessPoint elemetKt in it ~ this being the actua! binding tnfomiation for 
the redirected web ^Jvtt^ nsquest 



1 . A business registers a bindingTempiate A for a remotely hosted or redirected business service 
This bindingTempiate contains a bindingKey value Q that references a second 
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btndingTemf^ate 8. The brndinglemplata S !S typicaJfy contoiled by the organization that 
hosts the redirection service. This bindingTempiate e contains an accessPotnt element that 
points to the actual ho^ingRediredor service ft. 

2 A progi^m that wsnts to cali the service S that is registered m step one gets the binding 
infprmato for the advertised semce. This bindsnglemptate inforrhation contains a 
hostingRedirector element with the f^ndingKey Kfor the tsndinglerjipisJe S, 

3. The programmer takes the tsndtngKey K for and issues a get_bf ndtngOetaii message against 
the UDD! regisfty that the onglmi hindir^TeiTjpiaie A came fi^m. This retuins the data for 
biftdingTemplate B. The pn^gramtmr now has the address of the esrvics that impiements the 
redirection This mfom^ation is in the accessPoint element found in bIndingTemplate B This 
ofcfVice, to b<2 compif^snt knows how to respond to a qet b-ndtngOctaii message 

4 Ustrg t!ie o>iC},nat binding key 0 and "ssues a get^iiindingDetafis to tr»e rsdrieaoi t-^rv^iaj R 
Tnis service is responsible for resuming ttie actual binding infonmatJon rcr ihe ledirected 
business service S Of returning an error. The programmer has the chojce of caching thts 
bindtngTempiate if desirsdv 

Using ihf^= '^!oor-ii-m an cgari-jt o' -^^ w ' - of- ' \ ^.nossc-^ to use can control the 

info-r-sai^ jp thai ^- ,jst d ■ ' ..o/u i . . v c - b not only provides trcs hostmg 

organ!zatiOf5 Mfh the abilt^^ to manage feiiuaftons such as. dtsastfc' lecov^jry iocations. but also lets 
them specify the actua! URL that is used to mai<e a caii to the actuaf business sen/Ice, This URL 
can be keyed specSicaliy to cailer, or can be a gen^ location for the hosted or redir^ded 
service 

in any case, the origina! caller ts abie to find the technical wsb service {bindingT^plMe) 
advertised within the acfeisi business partner's data vwthout having Krow that any redirec^bn 
oecurred; 
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Appendix H: Details on «he validate catesomation cail 



Whenever save .btffiirisss, save„sercio- ^ ia\ e..tModel ans csfied, ai! osntenfe of any Included 
oiiegaiyBag informaSion may be o ieckjc ■ ;■ see that it is propetiy coded to match existing 
catftoories "i he reason given for ihfs is lo rfigxiniize consistency actx3ss category based searches. 

Opftrafor tjpedfic poitoy allows inteitxeiatioo of varioijs error returns to rssuft tn non-specified 
Densvior Consult the operations pi5ftcy of ttie operator at which you register data to understand 
the specific behaviors of any vaJidaSon perfofined, 

validate. categoHxatton 

The validatej:.ategorisaSian ser^ c-- pt :>:nr~s kvo fundiops, li is used to ye}% that a specific 
category' (keyVafue) exssts mihm the given taxonany. The sen/ice also opfenaiiy restricts tiie 
entities th^t may ise elas^fted within tiie category. 

Syntax: 

<v3iidat&„categGrizst!on g6f3e/fc="1,0" xmihs=*'r)ame_(jrwaMef" > 
<tMocieiKey/> 
<keyVaiue/> 

[ ^businessErrety^ j <btfan^S^iGe/> j <tModetf> 3 
</vaiidate;„<stegori5ES«csn> 

Arguments; 

The optionsi busirsessEnthy, businessService or ti^dodei parameters aj^ mufejallyexdusve. 

» modelKey. The identtlier of a nsgistsred tK'lodei tt>at is as a name^ace quatifier 
trat fmt^ti^ a specific taxonomy, 

* keyVatue: The <^egDO*'icfe*?fifef^ of itj© categofy v«tlTin icfenfil^^ taxonewiy. 

* businessEntfty; (QfjBona!) The bu^ne^n^ty structum foeirig categorized 

* businessServiee; {of^onat) The business servfce strudum being osSegorfeed. 

* tiWodet; (optoal) ThetiVlQdel sti^ctora being Ga^rtssd 
Behavior; 

To validate cr^tegori^ations of registry entries, it is sufficient to verify the category ider-iified by the 
i^ty Value parameter ejfists within the taxonomy identified by the tModelKey. 

Optsonaily, a businessEntsty, businessSer^/ice, or tiVlodei may be passed vwth the required vaiues. 
This addition^ information may be used by the texonomy vaiidation serv?ice to verify the^ the entity 
fs properly dassiffed mm Ms taxdnomy category. 



:>4? wsmme^appfopfiaife casegoFyicientitisf Being '247". 
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f?6tums; 

UjEjori successati swipleSon, a dispositioriReport is mtumed wth a single sycesss indicator, 
Caveais: 



tf any error occurs in processing this messags. a dispostSonReport stioictune vwii be returned to the 
caiier. The fdiowing erwr number infomiation wil be relevant: 

• EJnvaffdKeyPassesf: ftie Jf^lpdstKey v^ue passoii didn't match any knownlModei. 

• E_fnvaiidCate€fory: one of the keyVeiue vafues supplied did not corre^xind to a category 

with in the tEsxonomy iderttsfied by the tivJodeiKey , 

• E_catsQoHiatfonNotAf!owed- The opSona! busi^essE^^i^y, businessSefvice, or tModef 
provided does not confomi to restrictions piaced on the given category by the taxonomy 
PL(bfisher> 
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Appendix I: UHIi^ tModeis and Convenfions 



in order to faciiitste constsiency in Serviee Description (fMoxleii regis'ration. and provide a 
ffBmework for tneir basic organiz^ion wthin the UDDi registr/, a get of conventions has been 
established. This section desortbes the conventioris for registration of Sefvice i-X'Scripfioos, as weii 
• as a set of Utility tModeis that facifftate registration of common information and the sen/ices 
provided by the UDDi registry itseif. 

PDBI Type Taxononty 

Tho UDDI spec!fiv::^3})Gns provide a greai ti&si of f.exsfeiiity ir-. ^emii o? ihe iypes of infomiation that 
may be registered, A iype taxonomy has been estabiishe^i to assist irs generai c^ategori^ation of 
the types of tnfojm^on registered. In INs release, the type laxono^ny has been developed for ttie 
categorization of Sewice Deschptos. ortMod^s. Business or Seivice types may be inccnxjrate^j 
into this taxonomy at a later date. 

The approach to categorizatfon of tModeis within the UDDI Type Taxonomy is consi^ent with that 
used for each of the other taxoncsnies. The categofizaBcHi infomiaSon for eadi tModet is added to 
tt^e <cat8goieyB8.g> elements in a savsJModef message, A vcfeeyedKef essfene«> eiement Is 
added to the category bag to indicate the type of tl\^bdel mat is being metered. 

The yaiues used for keyed references a!® defined in the UDDI Type Taxonomy sh«m in the 
tModel descriptjoR table b^cwv, 

mod>$l Nstm: -idd i •• org -. ty^^es 

model Desctiptiom UDDi Type Taxonomy 



Taxonomy Values 

The table beiov^f describes xhQ UDDi !yp.','rs <c--.orTiy, As ti^e siruciurri; is iverarchfcai, the ParentlD 
column indicates the paixsni-child reiat^onships. The tModet key is the root of the structure. 
Categorization is ailoweci at ail levels of Ihe taxonorrsy. mti-\ the eKcepfiOh of the root key. 



(D 


ParsftttD 




DescripSion 








"Hiese fypes are i«e<3 fer tMotiefe 




ti«(Sfte! 


yes 


U'W)!J« idfsniifisr 




tMoci«i 


yes 




caiegwixasofi 






Catego.'izaiiein itgisORomy) 


speciScsiioft 




yes 


S?tK::ftC:-i!!c-n ft? 3 Web Sfir-.-n-.s; 




spessrscBiKSfs 


vm 


SpeciffoaSon for <s W«* Serviee usBig XML mrissaoss 
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"I^'Srlf-v. 




SfSficifics'iiOfi for irtsfscston wi8> 3 Web Service ysiiTg SOAf 




spestftcaixyi 




SpecificaSion for 3 Ws^s Ser-acs dfSSMfbed in WSDL 






yes 


Pnstaccii 




enotoooi 















tMode!: The UDD! type ta>iO^0=rty is .^tfuutured to «!!ow fot C3<ggoii^.af!on of rsgisJry entries ot^ier 
thsn tModeis. This key ts tr-r- loot oi the brsncTi of t^-^e tgxonon-iy that is intended for use in 
categorizatiori of !iV1cKfe-s wUhin the UDDi i-egisf^/ Csteaorca!: -f^ ;s njt nHov.ed wth this key 

identiRer; An identifier moxie', rspr-?s3rts a spacfsc eet v,j., o ..<,eti io unsqueiy identifv' 
ipfonTiatJon For exsmpi* a Dan & B'-adi^ireet D~lj-N-S® K-y-r-Dt-'- unfoueiy idenJiT"es companies 
giobaiiy i he D-lJ-?>;-?o, ■■m-ca taxonomy ts an idemmer jgxonorny 

namesf>3C8: A narn«;3pace iiVioc!ei represents a scoping constraint of domain for a sst of 
ffiformation. in conlr^ to an tder^Wer, a naWQ^ce does not have a predefined set of values 
within the domafft, but ecte to avoid (K^Hson®, it is smiiaf to the namespace funGtionaJity used for 
XML 

catsgortassttort: A oategorigafion tiViodel is used for inforniation t^onomiss within the UODi 
mglstry , NAIGS and UNSPSG are exaimples of estegdrizeSon tMddeis. 

specmcaSon: A ^{^fit^ion ^odei is used for tModeis that define interactSons with a Web 
Serv^fce. These interactions tyf»<»!ly include the defir^on of Sts set of requests and responses or 
ofhf^r f^^p^s of interaction that are prescribed by the service. tModsIs describing XiVSL, COM. Corba. 
.-t in\ . .;! st^r sers'ices are specific^csi tModeis. 

xmiSpec: An xmiSpec ti^odel is a refinertent of me spedficaiion tiWod^ type, « is used to 
indicate Siat me interac«on with the service is via Xi*^L The UODl API tiWodels are xmlSpec 
tModeis. 

soapSpec: Partner refining the xmiSpec S^ode! type, a soapSpec is used to indicate that 8ie 
interaction with the ssrvice is via SOAP. The UDDf APt IModeis &r& soapSpe tModels. in addition 
to xmlSpec tModels. 

wsdiSpec: A tModei for a Web Service descalbed using WSOL is categorized as a wsdiSpec, 

protocoi: A tMridet descnijing a protoc-a! of any sort 

transport; A iranspoa iModei is a sseo'ic tv'>e of C'Dtc.^o! i-fTTp. FTP, and SMTP are Vpes of 
trans:pt3ft tMod&4s. 

signatureComponent; A agnature compono-.i -t^ L^sed to. for f.as.es wtiere a singie tModei can !va 
represent a comptete spectficata for a Weo Ssa-'ics i'hfs ts the -case for sr>e.-.ificat;ons (ik-? 
RosettaNet, vth&re impiementation requires the composition of three tModeis to be comoiett- - a 
general tModel incScaiSng RNiF, one for the specific PIP, and one for the enor hantiiirtg setvice^. 
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Each c)f these tModels wuid be of type signature compc-nsrst, in addition to arty others as 
■ appropriate, 

The UDDi registry defines a number of tModefs to define oae services EacSi of the core 
{ModeSs are listed in thts sectidrj. 



!.! Nama: uddi -org ; inquiry 

mod&l Qescffp^om UDDI Ifrqijiry - Core SpeeffieaSon 



This tMode! defines the imwy ^Pi caffs for interadir^g wjh the UDDi re9ist7 

m<idlef D^dpticm - UDD! Pur-i.cation A» - Co. e SpecsficatJOR 

Catsgonzathn. - ( ^ ^ ^ t\ < 

■'"•lis jMoofsi defines the p. b'ioaT.nn API cdfts tor mi&rsu^ nu with im LLD reg s^i y 

modefOsiscnip^m; UDQlTsnommym 

modeiUUfO: tiUidj3FS66FB7-5FC3-4S2F-A351-C140DSBI38304 

Cat^otizatiom specification* jfjfllSpec, soaftSjiec 

This tModei defines the taxonorny matntenarice m cai!$ tor irvferading with the UDD! registry. 

UD0t Com t!ys<«eSs - Taxonomies 

An additions! set of iModets has been estabiished to assist in {^tegorizafion vvitfiin industry 
. taxoroTiies, There tModds are described beiowi 

moci&!Nssn&: ntis; -gov :n«ics : 1SS7 

mode} Desctiptlm: Business Taxonomvn NAiCS {1897 Retease) 

mOdlBl UtMD; vA3.i4 X COBSFEl 3 -.1.7 SF-- 4 1 3D - SASB- 5004DB8S$BB2 

^ COPYRIGHT 2000-5002 BY AR18A, tNC, im SiWATiOWAl BUSSNiiSS !*\CH!NS;S COftPOSATJON 

Ai.i. mmr$ Riis&WEo. 



Cst'sgorfzatim; categor 1 zat ion 
This WodeS dglines the NAiCS Wustry taxonomy. 



modei Osscripi^on: Product Taxonoms^r UNSPSC (Version 3.1) 
modelUUiD; xa. ■ v-.^-^ / 4=-OD-9PA8-45D4-A78C-044.nD14g3S4 

This Wode( defifvss the UNSPSC produot taxonomy, 

tWocf©/ A/sme; uddi •- org : mi sc - taxoncsHy 

WodelB&^iiptkmi Other Taxonomy 

Cai^otizBtkin: categor i zas; ion 

Ttiis%Sodef defines ao unideoglii^ taxofiomy. 

Additional tModds are defined to help register wthin isading trsdustry encoding schemes and 
standard protocols: This list is expected to lae expanded as appt^jpdate as the UDDl business 
registty exparids, 

m&di^Nsme: drjb-Gamrti-U-K-S 

Iftfode/ Oe$cj5fp«fo«; Dun & Bradstreet D-U-t^i-S® Uimb&- 

Cstegofization: idsmtifier 

This tModel is used for the Dun & Sfsdstreet D-U-N-S® Number iderttifier. Note that tiiis iMode! is 
inieaily re^stersd as part of t^® UDDI core tModels. Once the registry is in production, 
managemer^t of tht$ tModei is expected to be transferred to the Dun & BradsSreet pubfisher 
■ account. For more infemiatior}^ gee httD://ww.dhb;com . 
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tho^a sregi s ter - cow : s«pp 1 ie r ID 



model Dsscripthn: Thomas Registry Suppfiers 

model UUtB: u-d6 ■ Bl.RlBAF5-233S--4.*SS--M:aa-EA8E:S7i9505& 

Cafogoiizstiofj: i dent i f i er 

This ^.'lodei !S used for the Tharnys Register suppher idenJifier codes Note thai ihts iModel .s 
inttiaify regi^&red as part of the UDO! core IModeis. Once She registry is in productiofj, custody of 
this tModei is expected to be transferred to the ThtmQs Register publisher accourtt Fcsr mw« 
infofmation, see if'- ■ " " ' ' 



mo{f<slName: 
model O^rfptloft: 
mod&fUiMlS: 



E-maii based wflsb servies 

\3i.<-'d,S133SD49 1FF^=^ 48A0-ACSA EA10?8&OD3C6 
tratssporfe 



This tModei ts used to descnbe a web service that is \m<A&S tiimugh SMTP erjiaif tranmtissfdn& 
These trensmissjoRs may be either tjefvween people ot at^ifcafeons 



tModsi Nmm. 
mod&l D@saip0ort: 

"^hts tModei is ^ < , K 



Fax based mib service 

/eb service that fs invol<ed tiiroi^h fax transmis^pfts, Ttitese 



transmissions ma^ be eitiiet butween people or eppiicabons. 



^odei Descnptfon: He transfer protoco! (Jtp) based web setvice 
mod^UUlD. uuid 5?*CF5r«30-6::?A 4C5C>-8Slfi FS4"9CFSA«74 

Cat&gorizMion: i- rap isp^ >- 1- 

lh\s^ Modo )h used to descnbe <3 web setvh^e *hdi ? mok^o throjj^h fii- tr-ar^fprs via tiie 
protocol. 
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iMod^t hfem&: uddi -org ,- tslephone 

mod^l DB&aripmm TeiepHone based wsb service 

model UVID: v<xiid.3BEl 242? - SS3S -4260 

Categorization: spec i f M c.s t ion 

This f Model is used to deschUe a vs^^b service that is invokeef mrough a telephone caft and 
(nteracSon by vdce and/or touclvtone. 



(Model NamB: \-dd\ -oi-'V ; >ittp 

madaS l>esc(ipUon: An http or web bfovvser based w«b sea'ice 

CategodZSttott: ?• a; ;:5por t 

This tModei is used io dsscribe a web sen/ice that is mvoK^d tf^rougii 3 web browser and;or the 
http protocol 

RsgiMerls^g ««odels within ^ Tjfp$ TssxcuwfWsF 

When a new tModei is fisgistet^ vwttiin UDDi< its type can be ciassifted iwtnin ti ir.^r -if^work o: ti^-: 
UDDi Type TsxofiOTJiy, This ci3SSifi(^8on provides additiofvat bints to applications for xsfiat lyps of 
tModel fs being registered. For eadi af^fKlaie dassifi<«tiori, arid itsyed reference is added to 
toe cafegojy bag etemsnt for the tModei. 

As an ^ariipJe, the Dun & Bnadstreet D-t>H-S® Number is a type of identifier for an organisation, 
Wtthin tie UDDi type taxonomy, the dnb- com j D-tj- n~s fiwtod^ Is dassified as type (denser. 

The catsgoryBag eiement of the tMode! registered woufd be as fdiows : 

'-, ke yed R e f a r ence 

t.Mols i I'Aiv = " uuid : ClACF2SQ-907:^ - 4 4 04 - -3&B7S^SS2AB4« 
keyVolue = "identifier" 

k&yKame - "tNiodel is a uniqua adRnt:j.fier"> 
< / car, sg or y B ag > 

tModeiKey: This is the GUiD for the UDDI Types taxonomy, it is required, 

keyVsitse; This is the identifier for the categortzaSon vwthin the UDDI Types taxonomy. It is 

required, 

keyName: This is t!ie c.^:?crip'Jo- .r t--;.. ^n-.-'r^e' .vinr, the UDDI Typ^ taxoncmy. it is not 
required as a part of the rsQistration, but simply |:)fovides additional informafcn aboift the key 
sefected. 
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This section contains URL poimers to vafiDUiS specffic^ons and other documents that are pertinent 
in understanding this spedfication. 

W3C speeff!Gations, notes and drafts 

* XML nams^saces 

* SOAP 1.1 

UDDi specifications, white-papers and schemasi 

* UDDI AF>! sdiems 

* UDDioven/iew 

* UDDi tectinica! overview 

» UDDi Operators ^eciftcsfion 

* UODtiOrg 

* i^DDi X^Lstructurs ref&r«nc8 
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1 Terminoiosy 



The keywords "MUST", -^tliST NOT. "RECURRED" -SHALL', "SHALL. NOT', "SHOULLT. "Sf-iOULD 
NOT". "RECOMMtNDELT ' \^ , O"" C\A,.' ihis documisnt ars to be intsfpreted ss 

desicrlbedin RFC211Q. 



2 introductioii 



Ths progrsmmeiiie. interface provided for int^ding wHh systems that fdiow ttie Universaf Description 
Discover/ S integration (UDD!) spscifications make use of Exisnsible Uss^sxp Language {XJysL) and s 
reJated technology aiiiyd Sitii^e Objed Access Prcrfocoi {SOAP). v*iich is a speafcatfon for using 
XML in Sirn pie message based exd^anges. 

The UODI Version 2.0 API Spedficstjon de^nes apiatjximateiy 40 SOAP messages that are used to 
perfont! inqitiry ami publishing fundions against any UODI anDf^iant seivice rs^stry. This doojment 
OLrtitnes the aelaiis of each of ine XML strijctumsassodated wth these messages. 



2.1 Ser-vsce Ojscovw^ 

Tiia purpose of UDD! aaTiptjgnt reasstriss is to provide s s«(vtce disoovaiv platfoim on the World W:ds 
VV&b. Setvtce discovery is related to being able to aoVedise and locate inforrnation abouf different 
technical irvterfaces exposed by different parties. Sen/ices are interesting when you can discover thefrs, 
d^ermlne meir purpose, arid tten have ^«ware ttJsS is equipped for using a pakctSsrlype of Web 
service corrtp^ete a connee^on and derive i^rjef it ftwn a sen/tee, 

A UDDi ctsTj^iant re^slry pi^vfdes an MonrtsSioR frarnewst for desolbing services exposed by any 
erttity or business, in order to promote oo^ piafem service descriptim tiiat is suitat^e to a IMk- 
box'" Web environment, this descdpdon is rendered in Gross-piatform Xl^L 

Irhim data types 

The ifif;jfindfton tFMt nvske-^ t;p a .v;(;:.st!3i:Gn consists oi five data s{rucluf& types This divison by 
fofyfTtviiion u pc pro.'id^>s t^ii-npie partitions to assist in tfie rapid location and tffiderstanding of the 
differeni snioirnaiton ihat rr^akes up a rogistratfon, 

Tti8 five core t^'pes are shovw in figure 1. 

The^.e ffvs types mj-kt' ijp ihe ccmpiete smount of infom"iation provided vwthio the Uf^iQI ?.ei\'tce 
description framework. Each of tiiese XML structures contains a nuinijer of data Heid^'^ thai serve t-ither 
a busness or tectiriicai descriptive purpose. Explaining each of these structures and the nisaning and 
piacement of each fieid is the pnmaty purpose of fi-sis doci»Dent 

Tiiese structures are defttied in the UDO! Vernon 2,0 API sdiema. The schi^a defines appro»mats:!y 
25 requests end 15 responses, ead^ of whit^i contain these structures, referenoes to these stasctures. 
or summaty versions of these s&oitsturss, in this document we fitst explain tJiecore structures, and ther^ 
provide deseriptfcps of 8ie fndividuai sfrucfems used for frie request/respofise^^)^ 



' T{<8 isffp -oisctt box (ft this ccsrstsf* inphes !«a5 iho desc-"p,'v«> r<,-vT"<T{ en fo ,rf i s ccr p i,3 . -oor ■ is, . i - v i J » -j 

UUDt rrovines; a fr smewcrt: for cJ&sc.iixng any ksncJ of s«rvKsj. anil i^tow.'S sioragft si( 3S msi;* tiei-sii a&nut a sss-vice »!■!<« as 
miiomentaHon as desirsaj. 

■ !(i rM\. w:n-saai:!sr, fissids arfscsised ftithsw sieflieRis or stmbutes. 
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businessErrtJ^: infotmafion about the 
party who publishes iiTfofmatfon mnA a 
famify of services 



IModef; DsscHpfons of spsdgcgSons for 
sisrvicss or taxonomies. Basis for 



b»s(r)essSefvice; Dasoiptive 
infct niafton about s particui^r series? 



bindingTemplats: TechnicaS 
intormaSon about 3 sarvice entry point 
and e»ristmc«er! specs 



refer&f 6S to iM od e: s "f f - &s ■■ 
in($t1sse specfSeaikv^s for a 



pubiisherAssertfon: {n^ofmafeti about 
3 reiefiori^ip belwveen im parties, 
sssertec! by of bisth 



Each a" it tK^M*,^ !\ \>j--' ^ dV" f.r-f! <<. r< m ti" < rHotso-Ssh p 

si-'~>Mii( ! ni t-?-^ /ui teifT tsisexprt- ->i.edusnQ 

XML BccQid ■)Q .0 *fi^ M f .k ! c tiio 8 cirt types i-o! ! bie ice uo yopa'-aie bt.&tnesi>«;!> ma> pub'is*! 
mformattw aoout tte Web bt'Vice^> they off»r vs*ie;her the<=« s-^-^ ice<> are mtsy pants for interfaang 
v4th accounting systema or even servsces that allow customers to query the status of a factory a-der. 
Each business and the corresponding servsce dosciptiODb (both logto^ and tecJinicaJ descnp^jons) ait 
ex as «5<apa ate trcst^nae* of data vwfhin a UDDl regfs&y 



3.1 U«lcpeicfentlfi©rs 

The Indiviqtuai facts aEssut a businasis, fe serwices; tomcat Ir^orm^ or even irtfomiaSen about 
isfsedfications fdr services a^e k«pt separate* and atis aaa^sed individoaiiy by way of untcpe Irfenfi^ 
or keys. A UDO! registry assigris; these unique ideritjfi^s v^ert iftfofmatton Is first saved, and these 
tdentJfisrs cars be used iater as keys to access the siseeifie date instances on demsnci. 

Each unique identifter generated by. a UDD! registry tafces tfiefdrm of a UniversaHy Untque 10^ (UU!D), 
Teahnteafly, a UUi D is a hexadadrnai s^ng that hais b&en generated accofding to a very exacSng 
gigorithfn that is suffidentJy precfse a$ td previsht any two UUiDs torn ever being gerjer^ted 
dupifcate* 



Cnpyfia^it ® 2ij00 - 2002 ey AccenStife, An&a. mc Cofnm«ree Of^e. inc. FuaiSu Limifeci. Hewteti-P;3ci(.3r(i Company, 6 
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3.2 Contaimnent 

The individuai instemce data managed by a UDDt registry are sertKtive to the parent/cNld reiateships 
found fn the XML schans. This same containment reistiortship is seen in figure 1 for tne rore 
structures Th 'I !jPfnf,-^sErtt}vt,i\ tbi ; r -t.s =^ or more unique businij^^Sf n' -t; stnicto'S'^ 
Similarly , ii-idivtduai businessSefViCfe stn.icture& cosMsm specific instances of bindingTeriiplate data, 
vMch m turn contains tnfomiation that includes pointers to specific Instances of tMocfei strucltjres. 

ft is important to note thaS no ^ngie instance of a acm ^ructure%pe Is ever "ccsitatned" by mcjre than 
one parent strtK^ure. This means t)at only one spectfJe businessEntity structure {identified by its unique 
key vaiue) wiii ever eontaJn or be used to express information atrout a specrfic instance of s 
busfnessService statcture {aiso fdenSfied by its mm unique key vaiue). 

References, on tiie other hand, operate diffetentJy. We can see an example of this in figure 1 where the 
bindmgTempiate strudyres contain references to unique instances of tJvtod^ structures. References 
can t>e repeated v«ihin any number of the core tjfped dels instances such that many feferences to a 
siftgie unique instance are alfowed. 

Determii-ing what is a reference lo an instance of a core data type and what is a key for a core dats 
type wthin a specific instance )s straightfon,vafd. There are five core data types, and instances of each 
of tiiese types are idengfied by unique keys. The bustnessKsy found wtNn ttie bustitessEntity structure 
is a key, and not a reference, SfmSarty, the serviceKey and bindingKey vaJues found resped:ively vwthin 
fee businessSetvice end bindngTemfSate stnjetures are keys, ThQ same holds frue for the tMode! Key 
value found within the tModst structure. The pubtisherAsserdon's key is logically the concatenation of ail 
of its elements. 

References on the other hand, occur in severai pfaces, sspeciaiiy for tModels, When tModsis are 
referenced, as seen wittiin a bindingTemfSate structure, tiese occur wsthin a ifst stmcture designed for 
{tie r- irvose ot f-!o!ding references to tModete, TNs iist, mjf being one of the five core data types, is not 
!<ev"=->"i C'sn in^ .vvidua} instance. Rather, its ovw Idmtity is derived from the parent slnjctore thst 
CO- iU-. ns, (t -- nnd a cannot be ssparsted. Thus any key values directly contained in structures tiiat are 
not themselves one of tie fsve core structune types are r^ersnces. Examples indude tModelKey values 
found in lists wShfn btnjSngTernfrfate and categotizatfon and IdentJfteatfon schemes* fn vsrfiich ccmtext 
tl^e MoM represents a uniquefy ideo88ab!e namespace feference and qoaiifien 



Data structures are described by substnjcture breakdovms in tattes of tiie fdtowing fofm. 



f^tetd Nams 


Descriptiort 


Data Type 


Length 


sre written in 
nonmai font 


Desoriptfori of the field's mearting 
and whether it's 

♦ Anatfeibuteor 
en element 

• RepeatabteGf 
not 


Possibiis Qala 
Types tndude 

* structiire 
» string 

• UUiD 


If tf)e field's data type !s 
string, the fteld s length is 
given h«e in Unicode 
characters 


Raquired fi^ds 
are wiitten in 
boid fcsnt 



Moat of the data structures are also given in tfieir XML Sdiema representation. Rease use the UDOI 
XML Scnema as the definitive tectinicai reference, if needed. 
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5 The iHisinessEntity structure 



The busines&Enttly s{-ucti,re rears enis aii Kf>own infoixnation awa a t^us le t> u entity tnat pu:^iishes> 
dsscnpte mformatton about the sotJty as vste!) as tJie services that it otfers. From ao KML standpoint 
Iho tsusrsessEntfiy «stheti:^ievf8! data strxiclure that aGC(aTimod2teshoIdir?gdesc^^ inforrftstton 
about 8 busfness or enfety. Service cJescRpttons and tecJinical tnformatsori are expressed witiin a 
biisinessEntity by a containmertJ felafeonshtp. 



S.1 Stsiicf speciScaSo?! 

&ire»»? r«*» a<S<x H3ts>„" <ra Oc-v.r's-s ur or varied* /•» 
asiSjRe»>r rv+» u3ai contacts* liii' icarso^O" / 
<>sis«seRK. r«£»->«a«j:!l<S<ssi:sS:i«i:Ss<5'' !sis<jc;cwys«"a'* /> 





DBScripticn 


Data 
T>'pe 


Length 


busmsssKey 


Arnt {>• i !•> i^iL t: i ■! ! >r f a givtn tr sta oso 
a DiiS!ri8sshnH!>'' structurs, 


UUiD 




auttionzedName 


Attnbute. Th-s is the recorded name of tns individual tnst 
publish^ the bos n«?ssErtity data This data is gene'-ated 
by the controSing operator and should not be suppited 
withm save jsusiness of^i^tfons. 


StMtXJ 


255 


operator 


Att'-'-iuts? ^n"5 the cf rtff sti nam?^ of the liOOi rpo stn, ■^i^e 
operator that manages the fTJSster copy of ine 
bLSines-iFr'ity 'lata The controiiinj, ope'-c tcr records \ -> & 
daio at the brt^e datjs ts fedwed ! hts dett? , cfenera^ed and 
should not be supoiisd wiSitn save_bustnsss oparations 


str ng 




discoveryURis 


Opfeonal element. Phts is a {sst of Unifoitn Resocjrce 
Loc<5tDr<? (l,R\ \ tnat port to alternate ffie b sad '=;er^ ite 
d«cp/i \ TifK,h i'nj,ni Eat-h '•er-cioen hL'finH<^'?FnTr\ 
■^trjrtbief^ atitomat'oaivas iqned URu na*rt;i.itfTiiithf 
indivtduaf bossne^EnJ^ stnjcture, URL search is proviaaa 
vta 8nd_bus<ness caif, 


tnjct'ire 




"riame" 


Required repesating element. These are tne human 
rcadao'e fw^es fooordod for the buanebsEntd/ adi. rrei, 
V Uh a untq j-^ xir.j la^o vakie fo ssgntfy the ai iqu< 51 That 
they are expre^ed tn. Name seardi is pfoviaad vta 
fifx!_biisin8ss G3i!, Names may rjof be Umk. 


Hri -ig 
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USOi Version a Oais Stf'jf.{ws S?eS!Sc,fl>rjf< 



Fisid Name 




Data 
Type 


Lengti) 


description 


Opfionaf repeating etsstienl One or mors short business 
ciescrjptfohs, 0ns d^^pto Us alSowed pernationaf 
fanguage code supplied. 


Strjfig 


255 


conSacls 


Opitonaf eienienf. "mis is an optionaf list of coMad 

snformatfori. 


si:\j«ijre 




DiiSi nessServsces 


Optionai element. This is a list of one or more iogicai 
business service cJesaiptlons, 


structure 




identtfierSag 


Opbna! element. TNs is an opfc^ list of nams^value 
pairs that can be used to record id^tifiefslor a 
businessEntjty, The^ car^ be used dunng searcfi via 
find ^]^$in$sS' 


structure 




caiegofyBag 


Optional element. This is an opSon^ list of name-vafije 
pairs that are used to tag a busfngssEnOfy with specific 
taxonomy infomTafion (e.g. irKJustty, product or geographic 
ocKies). These can be used during search via 
find^business. 


staicture 





The ItNC n,UR! ttuLttre i-- u^vd ir -^1 j jk^ ntt. J .> f iRE aio ' w>!e d co ^ ^ aoui rie'-is Tiie 
exp eff"^ -.i niet hani<?fn f tr LKl s t ns ec s I c u k wi h n i <^ J t« r<^ HT 1 1 CFl The 
-^Apte t di tu tuix .im-^nt! lo'dc'^tw he - «v iilto es{'«Mi f tgu^ tsk'^t -ni 
and tv^-> sjcS"i i-Cf 'entions 3"6 oeftned ^-wthn i UDD! ofi^^viors i nopod thd Oihe con^ or tors corrs 
about aro t.'^e th s stt uctufif lo aoconmodate aiterr^ate means of discovety 



Field mim 


Description 


Data Type 


length 
2bZ 


■dtscoveryliRL 


Attnbjte qualified 'epea^ng element holdsny stnngs thai 
tepresent web siedressabie (we HTTP-GET) discovery 
doeuments. 


string 

.v/attnbutes 



5?1 1 dscn en.URL 



ha^-^ tnd ^fdua' discovery URL con-iists of a i attribute v.noss vfi\m d« igna\e ho UHL j < 
convento. and a stnng, found withtn »ie iaoay of the element fcach tmt !-!j-if'ici.'=iLnti!v 
stnicture is saved Via a caB to save ^business, the UDD! Operatot Site w(l! genetatp on - UP 
gt^ietatee URL Wii! point to an instance of either a busjnessEnfety or busines^EntirvExt sir icn.fe 
and the useType attnbute of tue discovet>,/URL vwi! bs: set to aither "businessEntety" or 
'tJUSinessEniftyExt* according to frte data type found whrie processing the :ssve:_bi«!n6$s 
message. The discoveryURLs coifedfon wsii bs augmented so that it inciudes this generated URt 
This URL can then used to retneve a specific instance of a businessEnttty, since the XML 
returned wif! befomtatted as a nomna! bysines^etaii message. 



* An estampSe of ar< aSeffi*iEti form of service ciscEjv-ory is seeri m !>i« e.CO Ham^woiU. as defined tty *« commesmnis! (nSiaSve A 
coftvcfitjon to provide f>a!r>tersi to 6CO fliscowry e^try pfststs cousrf talte aiSvansage tsf ttie sJruttu'es provicted in discoverytJHL? ay 
aaopSing the is«sTi^!i? vaiits ~'ECO' 
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UODiarg 



Field Name 


Description 


D3t3 

Type 


Length 


usstype 


Required attribiite that de^gnates the name of the 
convention that the {^erenced docun-kent ftdlows. Tw 
resetv^d eonvenjson v^ues am '-businessEntity" and 
"businessEfifityBef. URU qualified with these vaiues 
should pdnt to XML documsms of the same ^ffe as the 
useType va^us. 


string 


255 



Example: An example of ttie generated data for s gjven tonessEntity might look simitar to the 
foiiowing: 

<discQiveryURLs> 

<d{scov€*yURL useType="&U5fnessEntity^ 

htt&//wwaw,s6i^ODer8tor?bu gti^^^ 

</d{seoveryURL> 
<d!SC0tfefyURLs> 

S,2.2 name 

A businessEntJty KVkS' contain mom than one name, Mul^ie nanes are useful, for example, in order to 
spedfy tJoth the fegai nsme and a known abbrsviation «^ a buaf^sEn%. or in order to support 
romanfeatJoh. 

When s namiu is expressed in a specific language {such as the language into -which a name has been 
fonanised), it SHOULD carry the >£ml;lang ^felbute to ^grtiy Siis, When a name does not have an 
assodsted isnguage {such as a neologism no* a^odated wi&i a paJtculsr language}, the xmi:!ang 
attribute SHOULD be omitted. 

As is defined in tie XML ^seeiftcalion. an ocssufpence of thexmlilang attnbute irtdicates that the GOhtent 
to which it apptiss (namely the element on whic^s it is found and to all its ctiitdren, unless subsequently 
ovemddOT) is to fc>e interpretsd as being in a certain natural language. Legal values for suci-i a«nbs.rtes 
are specified in the IETF standard RFC 1 766 and tts succ8SS£>fs (including, as of the time of the 
present writing, RFC 3066). As ts itxiicated themln. language values begin with a prirnar/ iangudsge tag, 
and are optionally {<^{owed by a senes of hyjihervdelimited sub-tags for country or dialed identification; 
the tags are not case-ssf>sl8ve. Examples irsdude; "^N-us'. TR-ca". 

The same med^anism ap^ies to the name element within the businessSetvice statcture. 

S,23 contacts 

The coittacts structure provides a way for infomiatiDn to be registered \v,ih a businessEntiiy record .-sO 
that someone that finds tl've infom^ation can make human contact for any purpose. Since the 
infomiation held wthin the UDDI Operator Sit^ is freely avaitabie, some care si-ouio i-e tokei-' \-^isn 
considering the amount of contact inibmiatron to register Electronic mail addresses in isarticular may 
be the greatest conoe?^i if yoLi are senst^'9 to receiving ;.irs:5!;dted ma'-l. 

The contads stnjcture itself is i\ Sirnpis :o>\ea o-. c? ;X'r.tac.i str.jctures Vouli find {I'lSt the.'-e are (nmy 
aji^ections in the UDO! Version 2.0 APi schema. Like the discoveryURLs slnjcture - whidi is a 
container for csoe or more discoveryDRL ,strudxjres, the caitacts structure is a simj^e container where 
one or more contact stnjctures reside. 
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S.2.3.1 mmci 

The coniaci siriiciui's leis yoif record coriUict infotmavoii fc-' a person This infomiatiort cass consist 
of on'; or rncji-e opiiona! eiements, along vvi(ii a pef'son'& name. ConUsct iritorj-nai'on exists by 
OTntai'iment relationship 3k;re, and rio n-'ec/ianisros for {racking individual contact insisnces is 
provided by UOOi specifications. 



hof transifteration purposes {ag, twianization) the suggested appnoadi is to file tr.ultipie contaois. 



Field Name 


Desarjption 


Dstz Type 


Length 


ussType 


Optionai attjitujte ttiaf is used to detscribe the iyt>« of 
contact mfreaformtexi Suggested exarnpiss inciude 
''te(i^ir))cal:qoestiQns', "technlcai contact", 'establish 
accounf , "sai^ avjtsscf, eu: 


string 


2SS 


descdptOT 


dpijCMial elOTenl Zero or r-or^ ',5ftc;-i3gfr-q;;9iified" 
descriptions of the reason the contact shouid be ifsed. 


•String 


256 


pgrsonhiam© 


Required «!ement. Contacts should iist the r^anx? of the 
persori or nsr^e of the .iob fde that wil! be avsiiabfe behind 
tito oofitart. Examp'e-n of roles include ''admtntstratcir" or 

"webmastsr". 


string 


255 


phone 


Options! repeating eierrsent. Used to fioJd t^ephone 
numbers far the contad Thfe etement can be adorned 
viSth m opSona! useTyj:^ aftrtbute fordesGtiptive 
ptirposes. 


string 

w/attributes 




email 


Optional rep^gng eisment Used to hold emaii addtBsses 
for the contact. This elem^ can fee adorned vsiith an 
optional useType sttnbute for desctiptivs purposes. 


sttins 

w/attributes 


255 


addlrsss 


Opfcnai repeating eiernent This stfucture repr^ents the 
pnntaijte lines suitable for addressing an et?^/eiope. 


structure 





§,2,3,2 address 

Thf- add'-es'i stru-ti-re \% 3 '>mi ir st cS a j . ^e'^ts v.i^n n t^)^ cidd'' >5S no tta r^r Each 

aoire-ist ire elei'^f-n' s*^ - = ""r " ''^ s. --^ i ^ ' ^ stfi<=b c. fi't>poriSibie for pr«=:e'\f'iq 

i-jis. (M-rier c* an/ ■) ^ - ' ^ . :i - ' ^ * <. os ai^c h-ive thrp-e opl)0' iS! attnhite'j 
~ie u^-eTvpe d ■> * -i <\ < t.^t ^ - b< oe ' ilues d'r r at ^igr«{io.snt 

vMtnsr ^ UDDi ''f^'^ l/ra >--v.' ptoses fonf-^rtsn'jiTO >in in so, 

<-rd(^red fa'^hon i&ng t^e es prov Jea "hs aCtCco^- att.iL Jte "^hi, iMtKieiKpy !s ? tNto-dd 
■ ofo'cr^ce tf^dt <>pcct*''^s '*ia^ . cyN^niP ker^a vJC , Hjiri. givor ^ub'^oquent O'id'-^'isl ne eSonic^xs 
^ addrfeaoL ine elements are present at ai! are to be intetpreted by ttic add. ess sta'Cti-rf' sfsociats-j 
wfth the tModel that ss referenced For a descnption of how to use tModels in oider to give the 
sjmf^s addres^ine list structure and m^rsng, see Appendix E, Structured Address Exampte. 



ussi^fi as.uK5'i!.1tx ioural in the UDD) pf^jgfBmmgrs APf spsc;ificalicifi. £fr.b«*:<e(.i HTfvit fcs pr tiinbit.^ in ciascfipiioii iiijlffe, 
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UDG! smrmm 2 Data Sif UiSares Spec'Scaiitsr! 



Field Name 


Descriptioni 


Datatype 


Length 




Optional aSnbuts that is used to descj-ibe the type of 
address in fre^otm text. Suggested examples tndude 
-headquarlers", "sales offioe", "biiiing dspartmenf , efc. 




255 


sortCode 


OpSonai atfrtbLite ihat oafi be used to dnvs the behavior of 
external display mecharsistTis thai sort addresses. The 
aiggested values for sortCode indude numenc ortlenng 
values {e,g. 1 , 2. 3), aiphabetic chsrader ordeting values 
{e,g, a, b, o) or tiiefirst n positiDriS of reievantdarta within 
the address. 


string 


10 


tMocfelKey 


Optionai attribute. Thu; is tJse unique Key ref erence ihat 
irripiies ihat 'he ksyName ksyVaSue pairs given iyy 
subsequent addressLine eienients grs to be (nterpreled by 
the taxonG,'>iy associated wth tiie tModei thet is 
f^iterencfca 


string 


2S5 
41' 




Optjona! repeatij"K| eisfTient containing the actual address 

adorned each with an optional KeyName keyVaiue 
attubuie pair, rc^sther with the tModeiKey, keyName and 
keyVaiue qualify the addressLine in order to desai&e its 
meaning. 


w/attnbutes 


80 



5,2.3.3 addressLine 



A<-QiessLfn:; ek -^ents coniofj stnng data witn a ine length ttmif 60 ctidacter positions Each 
aQd'-essLtre eiernt li can he adcmed lAtn ODtional descnpttve a>tr,jijtes loyName a- id 
i^evVaiue bsih < t^iL 'e^^ r^ust oro^-ent sn (^ndn siddro<s<5 i '^f tf p tMoo::fl<p asMonPC to f^e 
addi-es^ -'jtr' t } e 6v do'nt. Ihi l e". "■^t Mr^s"/ i<^eo* pddres-, ItneMipt on.< stm-n rf>a 
Together wih the 3U'fr«>ss ^f^c ^ \t *• <■ i<,-s!\3ire af-d <\ •=«if\' the aaJ'^'?^ ^e 

ritr-ordipq to ti adc! e&s -^rfbc* *' ' !• v dncume'~» of tne e'eie r<-d tMo^>c 

S«>> Appu aix b for tjr exar t se-:; .an bi rupes^-ntea \A no 

t'^'cdeiKev fs DrL<.tdod Tcr t^e > >\arne ar<i -p>y;" je =t{irbute to 

Lisod >Mth( jt fr =;trwt!i,n., fo' ^\ <- r ^ ! ^ Of >i Mi^-e snfofrnatwn fo each ado's&aUne by 
« a tfu ke/N in <- tt-f^ue Snteixjt f^e i-<--»y Mai re and the keyVaiue attniatJtes are optional, 
^dt. e=5s tt ( K*< r ^ 3 nr.ant gnd m\\ oe letu'ned by the UDO! compftant regsstty tn the 
oraer ongnaisv praviaed duong a caii to save^tsusfness, 



The bustnassServtces staieture pnsvfdes a wrayfor describing infofmadson aboyt femtiies of services. 
Th(s simple colfedjpn accessor contains zero or more businessSerytce structures and has no other 
associated structures. 

The dentif58J«ag elwient allows businessEr^tsty ortMode^ structures to mciudo itforrnation about 
contTioo fom^s of fdentftcRtion ^c}> as D-U-N-S^ numbers tax idenfefiers etc Th"S data can be used 
to s gntfy tht (oentttv of the bustnessEnfty or can be used to agnffy the identity of the pufc*shfng partv 



,AG. am Micimy,sf«ms, irsc, Verisign, irso. Rights Re!^etv«c! 



inciuding data of this sort (s opijonai, but wtien used greatSy enhances the search behaviors exposed 
vfa the find_xx messages defined tn the UDDf Version 2 0 APi Specificaton For a full desc^pfeon of the 
stfuetures tnvoJved !n establishing m identtty, see Appendix A; Using identifiens. 

S,2S catogoryBag 

Sites aoioma^'-JSiiv paivii'-- \ ,r - i - -^i-'^ ' "--ee tt3xo'i'riie> f ^ it t )noj-.tfV 

CT-Jes (vics KAiCSs, pKWixt u'xi M,iv u^ib^"<cai(Onb {vid bNSFC) and jjeoyiaphy iv'a ISO 
ir>ctud!r>g data of this sort (s optonaf, bat when used greatly enharices the search betofors exposeo 
by the ffftoLxx messages cJelSned intfis UDDI Version 2.0 APi Spedficafion, For a M deschpSon of 
structures tnyoived In isstabff^ing eategorJza&Qfi fnfotmation, see Appendsx B: Usfng categoRzatfon. 
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6 The luiSinessService strtictii re 



The businessService sfructures each represent a iogicaf service dassifcalSon. The name of the 
element indudes the ter-nt "business- in m attempt to descrti>e ttie purpose of (his 'evei m tne service 
d8^.aH;iKi--i f-iier^rchy. Each busriessSefvice struckite ts the logical child of v=3 singl-s busin.3SsEnti1y 
slrjcturp. The (dent {> of the coni>3ining (parent) bussnessEntity is rfetemurieri bv'exaniining the 
embedded businessKsy value If no businessKey value is pr&se'^r, the txiSirsessKey must be 
obtatnsbit=' bv se3fx;h(ng for a busii'Sf-sKev value .r; .yy/ imard 5>iiucture containing tiie 
bustfte&sService. Each b{;S!n«ssSe'\'ii;o c-ien-ieni ccnis n% ;1escnDtiv'e infonnatiofi -.n Dusinei^ tenns 
oui[tn:ng the t^'ps of ttjchn-ca) services found \«thin esch {^jsinessSorvfice eiement. 

in =;on cfts-ss, buAfK^ss-sp would iike to Share or feuse se-'Vices e,§ vA^en a targe enterprise 
puoiisheT. s-5parate bus;; '^LsK3h^ti^y structures. This can be estsbiisited by using the businessService 
structure as a pn-ijACKon -a an already published businsssSeivice. 

Anv bu^-!ncL>sSef\'Sce projected in this way is not managed as a pari of the referendng bustnessEntity, 
bu; cent;-ail/ as a part of trie feferenced bu^nessEn%. This means tiiat dianges of tiie 
bustnessServtce by the rs^enenced fau^EiessEntity are automaticaify va!id for ttie service projecticsis 
done by refierendng businessEnt% stnjctures. 

In order to ^ecify both referenced and n^erencing busin8ssEn% stnjcturss osrectiy, setvice 
projedtons can only published by a save^busfness message >Mtf> 8ie referent buslmssKey 
presenUn the busin^sEhtfty structure and bcm the r^enancted bus^pessKey and the references 
bu^nessSefviee present in 8ie tsuanessSen/jce structure. 



6.1 StTisclxir^SpeclScagcm 



6.2 ^ttlistlmctij^ Bi^iolowri 











0ata 




Field Name 

businessKey 








Typo 


length 


i hfssEt-iBt te --onton 


a vA^en ttie business 


fvica data is 


UUID 


IT 




co'itain'-'^ . ^ ''\, 


.^KDtessed parent that 


already 
































no contain ng ps'-j-" 


hat nas vj)Xhn its data a 










the value d Sie bus)r! 


jss^ev that is tne oaren 


* of ti> 








businessService re« 


ijired to be provided, T 


bob^vior 








supDOils ttie abiiit^' *c; 


orowse through the pan 


pU t)i!d 








re'3tor'?ii!p'5 given 


V of tie core slen-^ents p 


s a sti"rt'nq 








po ! I' "i r-e bbrftnessKey rn-sy diftc torn t! le 


i)iiv=h,r. [ 






1 biiSfoessEntitv s businessKey to aiiow servsce 
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VDD\ Version Z Daw Stfociufc Soficificafion 



Field Name 


Descnption 


Data 
Type 


Length 


servteeKey 
--- ----- 1 


f hfs s t'le ir> que key for a gtven businessServtcs When 

ra c It t>j inessSeA/io^strucKHe pass an empty 
^ei ^ !t '^Ke-, y 1 ^H-* ? h(5, ygnrfic?. that a UUID s to ba 
gf ner^tt-a To i^pdate an ext'itng utjs nessS'^fv ice 

operation, the servsceKey values may not be blank. 

When sa^tng a new or updated service pfcsecfeoOi mss the 
serviESoKey of tne referenced businessService structmre. 


UUfD 


41 


name 


Optionsi repeating eli.f>' on' os--- * -i aJjbic ' 
names recorded for t^^e '-^ ?--^<^KSew i "r v^ha 
unique xml iang v^k « k s \ ht ' i ■< j < >m s^'-c 

calL Names nay not De tsiariK, 

VV^*'0 ^vpy^ j^'GW ujx^c^-'t^d ssrvicc prc^^^lion osss thc' 
N cf ■ cnc 0 Ihe rcfcrcrced bu&nessSefvice, here 




256 




ODtfor^ai oiern'3 tt Zero or more langNjags-quatffted lext 
dc&cnp{ions of a^e logical service family 


slnng 


255 




Th)S $fructure hotds the technical sen/tee descnpaori 
infcwmanoi re'ated to & gtven busmen? service fsmtly 






categdfyBag 


C-^tfon 'i f i^Ti ^ - -^t ir^' 'is of t im?- v ,li e 

laxotxr-'v^ nformatort (e g induistry, proaua or geographic 
codes) These can be used dunng search viafind^servtce, 
Se!» cstegorvBag under busnessEntstyfor a full 
descnpfion. 


structure 





0.av1 bindingTemplates 

The bincitnglefr.pistes slajduve is a cofnainer sor z&o or more bindingXef^tpiate structures, THis 
^mple cotiedion accessor has no other associated structure. 
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7 The bindingTempiate Structure 



Tcchfiica! di'i^Cfip^!ons of Web services are acco-^-^-roda*?!:; -,"?; ^nci'vidua! CGntsiried instanc*;s of 
bindinqTei'Tipipte stfuciv!r-53. T>-vs;v. 5tr-.,ct!.. es >pc--; icroeierfrisr-irig a tec nnscg! -jntry point or 

Opi!onj3f!v support fitv.otsiy hostec; se'v :es -vc ' as a s-'^-'S-g^i- 'aciit^' for descj-sDirig unsque 
1ech!!fCi!i chari-idensiics of s given HTtpien'ieniSJiop Suppol for technology and application specific 
paramesers and 5k5ii!ng$; files are also siipporteti. 

Since UODi i niatci puix-osse is to eriable descrsptiort and discovery of Service informatfon, tt is tiie 
bindingTsRipiate that presides tie most (ntenesSng tecimica! data. 

EaCti bindngTemplate structure has a^ngie Ic^tea! tjusines^ervice parent vvhich in turn has a angSe 
fogicat businessEntiiy parent. 



7.1 SMicture s|)eci^!loit 




7.2 Ss^lisstn^ctsim l$re@kclo«m 



Field Name 


Oescrtptton 


Data Type 


Length 




This is the unique key for a given isindingTempigte, 
When saving a iie^v bisxiincjIsmi^iSate staicture, 
pass an empty' isnciingKey value. This signifies that 
a IJUfD vatue is to generated. To update an 
existing btndiiig T&n-ipiate sti''Xture, pass, fl-te UUfD 
vaiue that corresponds lo tne existing 
bi!-idingTe!-np!ate instance. K tiiis data is received via 
an inquiry operation, the bindingKey vaiues may not 
t>e btan,k. 


UUlO 


41 


seri'iceKey 


This atrrii-iute is optionaS when the bsndingTsmpiate 
data is Qontained wsthin a fuiiy expressed parent that 
already contains a ssn,'iceKey value. If tfie 
bfndjnglempiate data is rendered into XML and has 
no cxjntaining parent that has yviir ^ii-i its data a 
servrceKey, the vaiue of the serviceKey tnst is the 
uittmate containing parent otttie binding T empiate is 
required to be provided. TNs bet>avfor supports the 
ability to bftjwse through tJje parent-(tid 
relaJicjnships given any of the care elements as a 
starting point. 


QJib 


'41 
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UODl.fifS 



FteW Name 


Des«iriptiort 


Data Type 


LengtiT 


descfiptton 


Optiong! rgpesting eiement, Zero or warn language- 
quatified ?ex{ descriptions of the technical service 
enlry point. 


string 


255 


access.f*o|nt 


Required 3ttr<bu1-^- q^nr'^^xl -jn-is-r' "lis ekN'riei-u 

sddre&s citable for calling a fsaaiajiar Wei^j service 
This may be a URL, an eledronic mat address, or 
even a leiephone number, No assumptions about 
f hs? type <f data in Jhis fSeid can be made withoutfirst 

un<'---'r^t.;r-ic '^a f'"? {ychnica! requirements 

associated with tne Web sejvice^ 






hosttrtgRedirectof 


element is adorned with a birKiingKey attribute, 
giving ih& redirected reference to a diSferent 
bindingTempjate, if you query a todfngTempiate 
and find a hosSngRedirectcsr value, you should 
retslsve tiiet birtdingTemplate and use ft in |:rface af 
the one containing tiie hc^SngRedirecfdr data. 


styipty 
w/attrifouies 






This ^dure is a M of zett> or more 
tl>!^odet!nstan<»lnfo eiemoits, Tfite data, tafca?^ in 
ttSal, sf>Qu!d form a d^ndt fingsjpnnl Siat can be 
used tD identify cmtpatible setvJces, 


structure 





The aceessPotnt eiemeni !S an artnLiote-quakried pointer to serv'ice entsy pomx- Ihe notion of seivice 
3t the i~T t^i^ iov.--;! se«n here is fasriy abstnact snd nisny types 3fitfy points are accommodated, 
A vfK-i;-' .-iti'ii-M : tr> providsd (rnvTioci URLType), The purpose df the LJRi,Tvi>«'fttriUjt8is -ofsalitate 
seacch^ng fof oniiy patnt;; fissoaateci wth a fxsiicuiaf hpe ef-.tf\' ptjirit. Arj exampjfs might be e 
purchase otcier service 'hat provides three e'^trv po^nii, o-ie for HTTP: one for SMTP, and one for F.AX 
ordsnpg. in thiS ermii-ya, ^ve'd find a bus-iessSer/ice ^serie.-it thai contains ti-iree bindingTempiaif; 
entries, each wtth identicai data vi4th tbe exception of the accessPoint value anci URLType vakm. 
Tiie valid values for URLType are; 

• malifo: de^gnates mat the accessPoint stn'ng is formatted as an elect' onic meii address 
reference, for example. maiito;ptjrch@fal>rikafn.cari. 

» http; designates that the accessPoint string is fonnatted an H FTP compatibse Uniform 
Resource Locator (URl). for example, http://www,fabrii<am,com/ptjrch.astng, 

» https: designates that the aecessPoht string fs fornaSed as a secure HTTP compatSbie URL, 
forexafnpie:https://Wvw.fabr}t<am,GCHt^^ 

• ftp: designates tttat the accessPoint sWng is formatted as a RP directory address, for 
exanriple ftp://ftp.fabfli<am;ccm'pub^ic. 



"t f: :.ort<::;: of ihc si- uciifre r'tm-vi iModeifrt&tafifieDstsits ttiai te t<x:ivi vimn a bMirsgTempiate stfucisjfe serves 3S a tefihnic^ 
!(f.gf^r(.l^^^^^ Tfiis (mac'Cpfifi; ss & series cf feJeres-sr.es lo linicueiy feavfa; sfssscificsstona an*'« coricept^. To a new ssfvSee that i« 

SM»:j^;jKey wMhin me fWcicifjtinsisf^sDetaits tJa;a for a inntiirigTempfafs Sr-sSsr^ft. 
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♦ fax, designates that the accgssPoir>t string is fortrjatteri as 3 teiephane riumter ih3t mW 
oonneci to a ffja-iifniie machine, for example 1 425 555 5565. 

♦ phone: designates that the acca$sPoint string is fomiatted as a tefephons number that m s 
connect to human or sultsbfe vdce or lone response based system, for example 1 425 555 
5555. 

♦ other, designates that the ai^essPoifit stdng is fomigtted as some otha address fomiat 
When this value fs used, one or more (rf 8ie MosM signatiffes found in the ifi^ocfeilnstanceinfo 
CDliection must tmpiy that a parttcuiar format or transport type is required. 

Tf „ noo n gR director «lemer t s •j'ieti tu o<^i<. ^ t at a i ngT<?r pht'^ tnt^ s a p<,i itc to a 
difter^nt btndingTemplate erttry The vat^e in pwdrng this ^actltty is seen when a tjusiness or entfiy 
wants to txpows 3 s^ce descnf^ioi {0 g advertise they have a s^ce available that suits s 
specife purpose) mat fs actually a service thai ts described m a separate foirvdtngTetrspiate record Thm 
nmghtoccur »^en a service isnsmoteyhr ted rr - h *hsUernent) orw*ienmafiysea''Cfo 

descnptfofjs could benefit from a stnoie service (jescr^oiion. 

Tht ho ^ iqRodtrector eieme'if ha-^ ^ s i \i c/^nfc Tt 1 he attribi-tf a 

1 oinrK \3iutthat =;sj!latie whr s t DDl!&.)str in«t^n bfo q er^ ^nt tiot^mmg the 
binatnaDeratf data tfist is to he lis&o. 

ici^'o tiie hu&ijnqRedtrertot rtjnbt Juunri mfsc.dope'Jdic.fefefoi the l-DO! Vet& 2 0 API 
Speciffc^on. 

Tn lit if n ^cr^ssof f^on^ainer hr one "jmo s tModehnstar c?fnfo jctures V^hpn 

tak ! ( j(Ui) 0 3tj}«. sjte'=entcdf a iModOini>tanoaCe*afis.$tru u ft *omi$ a *ei.hr!cJv 
Qe rrsp \ f igt; -^r u k^t. -nrn'=^«-'' i -> } Vdt i<^W»nr f 1 vsnrums 

tf.>C!.r<„ W-iattit i r ^ nK- n^- ( l nhij 

thai are implied by trie iMcKelKey values pfovidaa wih i'i;; rcyRsryfton Uuntjg an sntiLiity !or a service, 
an interested party coufd use this information to took for a spedrtc bindingTemptate ttiat contains a 
spedtlc {Mode! reference, or even a set of tModei referfjnces. By roigfistering a iipedfic ftiigerprint if> 
manner, a software developer can readily signify that they are asrtpatibie with the specifications 
implied in the tModelKey eiemer?ts exposed in this manner. 

7.2.3.1 tModelfhstenceinfo 



A tModel Irtstanceinfo stnjcture rspnesents the bindlhgTempiate instance specific details for a single 
tModsi by reference, 



Fleid Name 


Description 


Data 
Type 


Length 


tS)!od&iKey 


Psequttied Aanbute; This Is the unique ftey reference that 
imj^fss that the sen/ice ijeing described has 
irn)3fementatton details that are ^aecified by the 

spe:;jfic^"tiOf}p fisbocw'ed wi^ the tK4odel tttot i^; referenced 


string 


255 


description 


Opiiona! repealing etement, Thss is one or inore language 
quaiffied text descrif^ions ^nat designate v^>t)at roie a t.Model 
reference piays tn the overall service descripton. 


string 


255 



CopyrtSt"-i$ 2000 - 2002 by Acoefsuii-a, Af!t>a. int.. Commerce Orso, mc. Falmu Umleti. Hm'.oti-f&cksfei Compsfty, 12 IS 
rec^'^f03'r it'c )r-'<j'C'wp«r?>>ion,ii<t<=>rii)hc,ra 'ij&!"cssi M8C'iit!«fs>Co!r'0"'at<«' 'tocacJ; Coroi-ifa^tOf Orat 1»» Corf a'S'tiof SAP 
AG, Sim Micfcsyslems, inc., arid VeriSis.i. inc A!! Rights RcsBfvee!. 



Fieid Harm 




Data 
Type 


Imgth 


instanceDetaiSs 


Optional eternenJ. This element can be used wher. JModeJ 
reference $pectffc settings or other descriptive iofotwaJjon 
are required to either describe a tModeJ ^jedRc component 
of a s^ice cJesc?ip^Gn or support services thet require 
acJditeal teehnica! data aipport (e.g. via settir^gsorcsther 


structure 





7.2.3.2 instanceDetaiis 

TNs structure holds service instance spedfic infomiattion that is required to either underetand 8ia 
service tmpiernentation details relative to a specilic tModeiKey reference, or to provide further 
parameter and settings support, if present, this efsment should not be STipty, Because no singie 
contained el&neui is required in the schema descriptfon, this rule is called out here for danty. 



Field Hsm^ 




Data 
Type 


Length 


dewip^ 


Optionsi repeating eiement. Thfs language-qualified text 
eiement is intended for hddirig a description of the purpose 
and/or use of the partscuiar instanceDetaits entry. 


string 


■255 


ovafvie>f>Ooc 


"O^lsSj^em^ra 


structure 






Optional element. Used to contain settings parameters or a 
URL rBference to a fSe that contains settings or pafameters 
f&qair^d to use a specie facet of a bindingTempiate 
description, tf used to house a URL poirtter to a file, the 
suggested foftnai is U5=?L that is suSabte for retneving the 
swings Of parameters via HTTP-GET. 


string 


255 


J overviewDtJC 

This; optional siructune is provided as a placeholder for mstacJsta that dssGrit>es overvfew 
mfofmation atiGOt a partlcuiar tModei use within a bindingTemplate. 


Fiotd Name 


Description 


Data 
Type 


Length 




Optional repeating eiemervt. This language^ualtSed string 
is intended to hold a short descripSve overview of how a 
paftiojiar tModei is to !3e used. 


string 


255 "---' 




Opftonaf element. This string data element is to be used to 
hold a URL reference to a long form of an overview 
document ttiaf covers the way a particular tModsl specific 
reference is used as a comptsient of an overall web mmce 
description. The suggested fomnat is a URl that is suttabie 
for retrieving an HTML isased description via a 
brovvsrjror HTTP-GET operafion. 


string 


255 



OO, ^f'^o'ii Data 



8 The tModei structure 



S-- ng aHe to des-.nbe d Wf b &e'v.'!ce ar d 'hcf! f?>t <o ir e dc»crip on mteantrgal e lOdf h to {> jse^u 
iSunng searches is an important LDD! goai Another goal ss to pi wide a fda!% to make Inese 
aesGfiptions useful enough to team about hew to IntefSd wtb s setvice fhat you dcml know tnucJi 
about In order to do this, tJwe needs to be a way to maiK a descnpiion vwth (nforrfaijon^t 
designates how rt behaves vvhaf eonvsnsons st foltows, or what specfScations or standards the semce 
fs compitant wth Providing the ability to desotbe compBance With 0 ^cifwatoh concepft, or even a 
shared desjgn is one of the rdes that the tModei structure Ms. 

The tModel strucJure takes Srafotm of keyed metedata (data^^out data). Id a genera! sense, the 
purpose of a tModei within the UODi r^tstry i$ to provide a reference system based on abstraction 
Thus the kind of data that a tModei represents ? prettv nebulous \r> other words. 3 tMod^ rs'gist'ation 
can define just aoout an^'pq btt'n*h6aj!T€'^»'"s'«)cr ■'vr>nt!on=th,-'vf heor appi!« i for usmy 
tModets assource^ify c'c^'onifn ?co"'p>!0*ij ^ - wrr cfc' ao.^ re''e''enco'=i 

The infofmatidn that irakes up a tMud^ is qui*e <>tmpie Thp-'^s s a key, 1^ name ati optjcna aescnptic^ 
and then 8 URL that points somewhere presumably scHinewhere where the cunous can go to find out 
more about tfie actu^ concept represented by the metadata m the tModei tf^if. 



S.1 Two mmmim&B 

Tht'e are iwo places wthin a businessEnitty reg sti aSon that youii find references la tKtodefs fn ihts 
regard tModolb i=? e s>f>e'^ ?' Wh8ieai> the other data vwthm the busirtes^ntity {e g bustnessServfce 
ana Dinaing t empiate aata} exists un quely v«th one untqu^y keyed instance as a mwber of one 
unique parent DjsinesscBtity tM(xk-'Js are used as references. This means that yoti It find retemnccs to 
<^pi*c.ftcmiod8i instances m marv businessEnttty sfeudurss 

The primary rc^e that a tModei fSays is to represetit a technical ^eaftcalion An example m ght be a 
speafication that outlines wire pFOtoco's, interchange formats and interchsngs seqasncmg tutes 
Exatipies can be seen in the RosattaNet Partne' Interface Processes specif icat Dn tne Open 
Appiic^inine Gto..p i'tt(\,f i!n Spenffcc-t!! p ' r d nous Eiectronfc Documcr' Irfp'-cnangr *'EDi 1 
effDft$, 

Soft^A'are t^at com' oupfcates w tn cthe*" sottv\,'e 1 e ^ u oi.5> some communication mcd.o'T. ii ivatu'Diy 
adneres to some ptis-agreed ^csficattons in situations where this ts true the designers of the 
^clftcations can estebllsh a wiique technic^ identty withir* a UODi ne^stry by regtstering ir^ofmatton 
about the speafiesto m a tModei . 

Ono 'ei.ntpttr' r 'h-, way uiher partie-? car «\r e=^:t. the evaiabflityofWebsewcesthatare 
COT pi art V i'-h 1 < ( >e- in rit >n jy sir 'ply mc\t i ng -j eifrence to the tiVIodet idenhfiar (caiied a 
tM G<'itK y) n 0 t. r It. ti" ^prvice desc-nptiC-^«: u rr!ng>mf:^,;?fp data 

T^ii'- If T'^a<~i" fa- ' Sates s> arc hfi\i for tec,'s*ered "'no i>i.rvn.e& {'^a^ a ^ ui Da\ V:> -'tw pa ti j of 
•■pi n<^i( ilon i re^^u^f^v the >j'-ort,rtf1odetK^y value joj^ai fin o'.t iMiPtr*-r? .'-qjcuh 
puat-ess cr eRt)^, h'as registeieci a Web servirettiat references ti&t tModei Key h s *he 
tModelKey becomes a technical fingerprint tnat is untque to a gtvmspecsficafion. 



Copyr>£iht © SOftO - V002 AcccRUfj, Afl&a, inc. Cowmense Ot.«, Inc. ryjijBU Liftsited, Hcsk!e>{i-P3f;K=3rd Compsn;/ i? Zd 
TiscfifioSOfiies, inc.. tmei Coipcraiion, inEemafsonai Sijsmsss Sv^achines Cf*rpof3t(cf«, Micfosoft Cofpa'aiscn, Omcie Corporaiion, SAP 
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8,1.2 Oefjnfog an abstract namespace reference 

The other place where SMtxsei references are usee; is vwthin ihe identfierBag. categoryBsg, address 
and pubffeherAssertion structures thai are ussed to define cs-ganizatoai idsmity ana vanoijs 
dassifications Used m Ms ccwitexS, the IModet reference represents a reiatianship bsiween th«; keyed 
name-value pairs Xo Ihe super-name, or namespace within wfjich itis name-value pairs are .Teaningfui 

An example of {Ns can be seen in tJie way a business or entity can express t\-:e fact that their US te>- 
code identifier {vi't-itch they are sure &?ey ars known by to their partners and customers) is a particulaf 
vaiue. To do this, let's assume that we find a tMode! that is named "US Tax Codas", v>/ith a description 
"United States business tax Code numbers as deftned by ths United States Internal Revenue Service", 
Ift this regard, the tModei still represents a specific concept - but instead of being a techntcaS 
specifjcatjon, it represents a uniqus area wimtn which tax code !D's have a parSojar msariing. 

Once this meaning is established, a business can use the ^odeiKey fcx tJie tax code tModei as a 
unique neferenee that qualifies the mmaSnder of the data that mates up ah orttry in the iderttifietBag 

data. 

To get things starte<i, tf>e U{:)Di Operator Sites have registered a number of useful tModefs, including 
NAiCS {an industry code taxcnomyK UNSPC (a product and sen/fce categoty code taxonomy), and 
iSO 3166 {s geographtcai region code taxoncsriy). 



S.2 l^rticlsim Specification 




!" 5W5f<;!;-:t.;ars!i«*ijajii!e«rs!ie<5'< y's 




a3 Swbs«r«ctHi« bmakdtewn 



Field Name 


Description 


Data 
Type 


Length 




Required Attribute Tl-,i<: is She (.Kiique tjey for a given 
tMods! siructurs. When sav-no a new tMode! structure, 
pass an empty tModeiKey vaiue. This signifies ttiat a UUID 
vaiue is to be generated. To update an existing iMcxM 
strudwe, pass the tModelKey value that correspotids to ah 
existing tModel Instance. 


string 


255 


auS-ioftzedName 


Attribute. This i$ ttie recorded nmse of the individual that 
pu!3ifahed thetModei data. Thi& data is cakxiiated by the 
controliing operator and should not be sup.Diisd within 
save ,i!vbdei operations. 


string 


,?55 


operator 


Attribute. Thi,s is the certified name of the UDDI registiy ate 
operator that manages the master copy of thelMode! data. 
The contfoiiifig operator records this data at the time data is 
saved. This data ss calculated and should not be supplied 
within 3ave_tMode! operations- 


stnng 


255 



C«pv»ight O 200O • »y AccfSRtuf e. Afifca, )fw,. Commsrc« Ontj, tnc. Pujitsi! UsrHivi, Hewtesi-Packarc! Company. i2 2 1 
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UDfii org 



Field Name 


Descflptton 


Data 
Type 


Length 


name 


Required eiefnent. This is name reecstitKi for the 
tModei. Name search is provtflled via ffnci_tModt-i call. 
Names may not be b(sni<, and shoufd be meaningfui to 
someone lArfio looks atthe tMod-ei. The narfie ^ouid be 
fcsmaneCI as 3 URf and. as a consequence, the xmi;tang 
attribute of ths name element shouid not he used 


strsfig 


255 


descnpUon 


Optionai repeating eiem&rjl One or rnore short language- 
quaiified de&Driptsons. One description is allowed per 
nahonai ianguage code suspited. 


string 




overviexAOoc 


Opfjona! efentent Usea So "0',5,t c-\''r e^^tofcmote 
descnptsv.-^ ir'ormation or 0- > , --e 'ited to the tA-locfs! 
Sen tna sjbs'Jucture breakdown t-T c>'S".' 'iv.Cioc in 
section Tf^e bindingTrimpfsfe slruclure 


strijcture 




fdentffjerfiag 


Optonai eiemsnt This i? .^r opt'on,:-! Si^st o' ngnie-value 
pairs that can u^^ro !o reccrd scc^i.'icatsor numtjer-? *or a 
tModel, These ca- - dt n - j ^c n: v i -! I'MM' kI. f 
See^eful aesrr'rtKMC^hi < it ^ei t n ih" bustne&^S 't y 
section of thi* ooi 0 1 Ai. - ^ < a i ; 
!di2(>tifiers^ 


structure 




caJegoryBag 


0>tf.'V ' , < .viJS 

paif^ thfli are ussc; to taq g IMoae; wiih soeofic taxonomy 

tJ osscrj-t^ino titts e'erpsnt sn the bustnassEntUy feedion 
of {his docaJtnent and fn Appends S; Using caJegdhzaBon 


structure 
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UOQ! Veision 2 E>ai3 Sifyciwre Sper.iScafion 



d The pubiisherAssertiofi structure 



Msny businesses, like large enJerpnses or marketfrfaces. are no; effsdtveiy represented by a single 
businessEntity, since their desaiption and discovery are iiteiy to be diverse. As a consequence, 
several bustnessEnSty stfucSures can be pubfished, representing indwiduai sub^diarfes of a iargs 
enteipnse or indivicfua! partt'dpants a ma*etp)ace~ N^erttieisssi they sf I represent a more or Jess 
coupled community and woufd like to make some of their reiaUonshtps visible in their UDDI 
rsgistratjons. Themfors, ts«o nsiatsd bu^nesses use the xxjsubiii^erAssertion messages, pubiishing 
assertions of buaness retationshipa 

in order to eJtminete the posability ti>at one pubiisher claims a relationship between both biisinesses 
that IS in fact not redprncsSy recognized* both publishers have to agree that the retatfon^ip is valid by 
PMbiishing their own pubiisherAssertfon. Therefore, both pubiishets have to ps.^iis}'! exactly tbs same 
information. When this happens, the retetionshlp becomes vistoe. i^ore detailed ijifcrmaton is g?ven in 
the appendices for the UDDI Version 2.0 API Specification. 

In the case ti"»at a publisher is responsible for both businesses, tiie reiationsiiip outmiaticaiiy becomes 
vlstbie after pui^iisfiing lusi ons of Doirt assertions that make up the relationship, 

The pubi!sherA;5sertion s<r\icture constsls of the jnree eitments frortiKey {tho first biisinessKey), toKey 
{the second bijamessKey i and keyedRefsfersce, The i<8y8dReference designates the asserted 
relationship type in terms d a i^eyName keyVaitie pair within a tivksdei, uniquely referenced by a 
tModslKey All three parts of the keyedRefSfgnce - 8ie IModeiKey. the keyName, and the keyVa ue - 
are mandatory in this context Empty (zero iength) keyNams and keyVs^iss elements are pemiitted. 



^ii-lsweiit. rev- "UiM; ^ivcKaKsy" /» 



Field Name 


Description 


Data Type 


Length 


from Key 


F^equired eietnisnt. Th(s is the unique key reference to 
the first businessEntity the assertion is made for. 


UUID 


41 


toKey 


Reqiiitied element. This ss the unique key reference to 
tiie second businessEntity the assertion is made for. 


UUiQ 


41 


feeyetSReferenoe 


Required element. This designates the relationship t^'pe 
the asseition is made for, represented iay the induded 
ti^odeiKey and desolised by xm inciuded ke>^ame 
key Valae pair 


empty 
w/'attributes 
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10 A|^iiiilxA:U$iii^ldetflifiers 



1 0.1 The Identifier dil^jm 

oti of t»e aeston goa!^ a'>soc!;5'«'1 ^^-.t' ' ODD) e^'4> a 3 s * ai iansd'-i' iP n-a v! 

AifJ ::ien ifieci fhs? p fpo^^e n{ tdcm^le - t*-* O"" - - ^ s ' ^ a' -^--v ot- e'-s toiro tn*^ 

oubhshi d fr'^orf'-aticn jsiq no(f> crn,^ o.' ' - v ^ t^-- L _ S TiNejs G >b.i' ui I'li i 

r- here vGlN;' tde itiPi ts v , ,a> n.T iH'u, rocja xi ess. o' .v^ic het 
ihess are pnvare of shared. 

\ /ivp , 0 ) lev <k t t< '.fjtr- ar, ^urr ^ \ >>^t )<■ fs -^ot al ^avs imrj-vediately apparent vvh?t 

the ien'itiei uj ^.^oonts Fc nst?'''-e - /!"c 

123-42-6789 

St-jnoing alone, w coi.ld t!> and gue^s lA'hat thr oofnt»inat on o' J g a? d fomiattfng characters 
implies. However, ff we knew thatihfs vaas a Uofted States Soda! Secuti^ numiser, we vW)uf«3 then 
have a beSer context a«d ynderstehd that tNs stririg.^hiie sti not dear, at ieaat idenMes CMie or mom 
pereoPS remaps even a imrvg one Expressed as a name / ysim par, thp identifier nvgH then took iwe 
j^tefoffowihg: 

Onxtsd Spates Social Sescurlfcy Number, 123-45-6789 
Even vwtK this ew tnfomiatfon a seafich mechanrsm based on ioosely qiiatied pairs [rw-e of 
iden f 8f type !dv>ntfr!er value), two d^erent parties mtght spsit or Jormat efthet part of 8ic mfomianon 
differentJy, and wth the end result tj^r^ g dimini^ed value for iaearching- 

The goal of cou»^, is to Uefihe a stmf^e m^haht^ that dtsamJagustes the conceptual mesnmgs 
b^trvd tdentifi^ and exposes them i« ways thM are r^taWe and predictabJe enougti to lise, and yet 
are simpie enatgh stftjctctraJly to bs easy to undefstand and extend. 



1 Identifier ctorac^HSfiic& 

Wh&t^ we look at various types of stmcte tdenfifiere. some commm desff^bic chafrc^eist.cs 'oscct^l 
evident In gaierat tetws a system of identiers th^ ans used to U-thiaie -^-^ar-hira r^^eri { > 

♦ ResotvaWe. idenSfiers can be used in a way that s^iows the meaning of fne den<fPer to a*! 
determined. For ffistancsv a popularbusiiiesg identifier m provided by Dun & 
Bradstreet tn the fomf of D-U^N-S* nurtibefs. When you know an organization's 
number, you can use thfs to reiiabfy distinguish one of^iantaation from another. 

• Distfnguishabio i •enlfie'^ ran be ased m a way that you can teii ^ ff -r i-- 
betng Ubed rr \/dj on specu v Vx-f'-a' k,nd of tdenfefier you <tre usir g '• vih -^r 
This means you can tei! that ^^oide,-^tf1f2f^^ die tne same kind of ide t i. x <!■ ' rrrti\o'j, 
{e.g. two D-U'N-S"-'' numbers, versus ? tax icentjtier o"- ?n orqan it m ^a! t en Ders>,'-!ip numtre'- , 

« Extensfbfe; i he way that sea'cnabsp idtntifter^ o'. oePred shDuk^ br- 1 isv to <■ <t- ^d -o th?t 
anyone c^n regi-ster another type of idfanttfier without having to create costiy or difficult 
infrastaicture. The search rnecfianisms that use iden^fiefs should be able to accommodate 
newly registered lyp«s wthoDt any dianges to scrftware and arywie shoufd be abie to start 
using the new types immediately. 

With m% in mind, iefs took at the way that identifiers are used in tie UDDI data ^ruduies 
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10.2.1 Using ident^ers 

instead of defining a simple property meiv you couid attach a k&fmrti or a sirnpie identifiesr f^eid, 
UODf defines the notion of annotafing or attadisng idengfiers to data. Two of the core data types 
^Gffted by UDD! provide a StiXfdure to support aaaching kienMers to data. These gre the 
businessEntity and the tModel sfrucUires. By providing a placeholder for aSaching identifiers to these 
two root data types, any number of ideniiSers can be used for a variety of purposes- 



busioessEotity; Fsbriitam inc. 
businessKey; E4S 



iModeS: HomeGrown Purchase Order 
URL: htt|>://fabfiit3m-com/spec.ht?Ti 



tdenefierBag 



In figure 2 we see that bustnessErroty and tMode! structures bot.h have a piaceholder eSemenS named 
identtferBag' '. This struci^iro ,i ijcnetcsi-pjrvoiso Dlace'-o a--r foi any maiUv oi diabnct. ideritiiiti^s. in 
this exampie. we sen f-vs types of identifiars in use in a way tb&\ accorrirsnodates the Kinds of searching 
thst might ba requirecf lo locate tJuarjgsses or tiModats, 

Fo- instance, K is itkeiy that someone wants to find the types (rfteehnicssf Wafe services ihat^ 
exposed by a given business wouid ^atch by a btisrrsess idehHSer, Used in Ms way^ idehfffieps can 
represent bifsinsss identifier types, in t\e ^ampfe siiawn in 5ggsr& 2, m sea that the individuai who 
registered the businessEntitydafa specified a O^U-N-S'^ nurRb®^, a Gtobsi Locafioh Nianber, and a US 
Tax; Code identifier^*. 

nr. t! 1. other hs!x!> since a tlVlodaJ is a faidy abstract concept. I wight care more that a tModet 
i e[>f.;s;,:;r5ts an identifier, and that if was regtstered by a pafttcutar busnessEnttty. In the example in 
figure 2. >>ve have shovjn some mors stostract identifier types and can leii that the tModel that describes 
ths wriv i; saf i »br.k<vn^ purchasing Well seivice has been marked vwth information that identifies fiie 
d;ii,.i Lis bemg --eiaied to ihe btisinessEntity record with the theoreticai bu^nessKey vsiue 645. A 
second sdentifter trirjrKs the m(xM as a specfficatton. 

Two idenfc t^s tiaye been identified and made a core part of the UDDi Operator registries, so far. 
Tiiese are the Dun ABradstreetD-U-N-S* mflrjbers ahd the Thomas fJegtster ^sttppfier tOs'* 

tttentlfier Name tfiSodelname 

D-U-N^ dnb-com:DrU-N-S 

Thornas Regi^er thc»Tvasn8gisterrCom;supp!lerlD 

10,2.2 Stmctwm SpecSficatfoo 



i3,jl6(cie. R Lx*i>fiv«iS ake a uag -- fewt is hss a cdiectort thtrifjS in a. To ses nhsKs irs it, you f>ave to took inside 

IT! St^f! cfis^fsffl, me sctuij! narneivaioe prt^ef^!^« were abbfsviatsd fof 'Jm sake of aiirspitSity. 

See hsu>:/jXwA'.t}samasregsstef.com. 

CopviX3^>; 2000 ■ 2002 by AscsntufS, Ar\t>S. inc . Coftsmeroe 0>!« tor,. Pi!|itsi( nmked. HewioK-Paticard Company i2 25 
Tftsihnoiojjifisi, )PTC„ (ritei Corporstion. Irstftfnatiwis! Susinsss teoftinss Corpcifaiioti. Mteosoti Corpo>£«fnn. Ofsttie Cofpofaiitsn, SAP 
AG, Sun MiCfMysiet^iS, frsf;., ami VSffiSiga ific. Ain^igh^^ 



-ror- thtsy strtJCture t'efintion jve se*- thai an fueibftet \ & an element thst ti<^d$ ?ero or nure 
instances of someSiing caJied a keysdRsfefenc-e When we look at ^at structum, we see 



if -s> ' -Key v/rs-<- lf*ol« X&y ie»*opt'0« , 



toon exsmini ig *hts we see a generatt-punx^e sfructum for a name-vaSus patr, wti one cjnous 
3< id tio, >ai '•efe'-ence to 3 tModei strudure it is *fs extra ambtM that maKes the identtfi et sdieme 
extensfbis by affovwng tModefs to be us&A as coriceptuaf namespace quaiifiers- 

(e rst- id) c hfs !t tner shi .uid Ue easv to see how the pxamp^e m figure 2 functions Assuming that 
th r ,siK,^ t<^^l^ -Joinrd i-efivpfypf^s -^hown/cufdsrchrpfaencd one of five different 
tMt\i S ti ilic nform-r! n \ 1 c dtn da'ieg-ly^.rm th(»ot"=;cus&>oT of the tModei structure in this 
-jx fx tn K 3 fc;otext-> <A\ s'~i.u(-< -> s-e hcM tf^o tModsl stTUCturs fs useful 38 3 

(.•-nuJ c 1 r^se "onct-p eu-t'v ^ i >h-(5>is on n c concepts of softwate 

re< itr ^^tr r s je' li iic S op -^vhwmr - la ■^.uu s) «! AbSt rtion staictur^ and the next 

1 1 < ai. a way to deftnt. a ye ier^l UvRonomy namespace !<ey 
I 1 f f -^sult ts tfiat ym can register a tlvSodel to represeftl an (dea. and ttien use a reference to that 
t f 5s, part £^ a genera! discovery msci'»anSsm that aliows unknown *ads to be disooversd and 
expigfned. 



Copytighi * 2000 - ?002 by Accei>t;jf«f, Anb?«. ire . Commerce Or-?', tr.;. Fupisi; Lin«:e^, i-ievv!ea-f>A-.k«fc! Comoanv, i2 2*! 
AG, Sijn ^iicfcsysiems, inc.. arvci VeriSign, inc. Aii RigMs Reservstj. 



URDt V.' w. ; Das S urtiJt<3 Sat 



11 Appendix Bs Using categorization 



Gategn.vatior. e nj the it)^ f * ^ - uc't'-^gr^v mor^, alon to a;?tr- iP the JOD! d'ernbuied 
►•sgtstry was a key ctewgn cpg! vv uir jt cjttjqonzateon and the a&ltty to spyctfy that infofrnation be 
targentfaiiy leiated to some \\e>i-k >oiAn ^str/, product or geographic categonzation code set 
focaijnq data witNn ths UDDi reqtstry w-ousd ptove to be too diffjcttit 

'\i {>^Q sjrne time ii r 'n^p>artic.i! cibb.ume n\at the UDD -ea -t- - '^i- ^--t-^'il fo' r -or mI j u uosv' 
■ >js n <?s fei ^"^f Wifn ? projected neat term populaitor ci irtt hi. nc3rf^ 1 thoi <sar-J '■iurn ion di^hnct 
enttjcj it tsuniikely that seatr hire for businesses ^atsattsfy a patticdt^! Sfntf- ia vil v dc a 
manageably s!£ed rssuit set For » < -cniiie &ip)x>&e we searched for aii bt-sf!T='?s»<^ trat havo ci-^satfieo 
ihOTseives wth a pattcuiar .fuftAtf> Loce - rciai! Even we searched wrthin *h!S ^pe; tfic ndust-^v 
das<i*f'C3=«t)on the breadth of the cataqo'%' < «t tikelv that we'f! ftpd tens of thot,S3pns of compai-tes 
thf'are'f'aicrscin&ornev'/sy { ink y t r f^^<:.i , r f^f -^Hil category 

S'-v.^^f a^-^ <.o"Skler=ifnq<^(rout'Mh'-^o i.^tt , r r-^ipN^ci and the exact value 

ms ch ratui e of rhe UDDi categorization faai!^y vVien v(x kx ^ft ' d »pooiftc category along with you*- 
UDDi regtstration data, onty peopis searchmgforthateXatS category vvili ftnd your regdts/For exampis. 
la the case where one business maiics itsetf as I^M - pet-food", and another sSrhpiy us$s "retar. tfie 
speciaitzation pnd gsoefatsz^on across cateqanes of any parfjater categonzation scheme or 
taxoncT'^y rot k ^c-.v^ <-g *hi=- UD1\ <5earch faaiftv 

Mcremtetiiosn vrchf<<-iifti &f vfcqi ej* ti-v,- s A'iedge {rf tho meanings of 

spertttr catogofies ana that fwia *i-e aoiiity to cfosweto^oncb <ia o&s related (^tegones* Such is the 
roie of more t-adttionai search engines. The design of UDD! allows stmpliffed fc»n^s of searching and 
alloM the parties that pi^tsh data atout It^emselyes* and^a^^^ 

provide categon/ation data that can be used by nchsr smpdh faoilties that w!f be created above t)B 
UDO! fedinfca! layer. 




Figure 3 



in i:gure 3 w-i see the itered searcti cofioept illustrated The role of search portals a^id niari^eipiaa^s wiil 
support the business level search facsities for such acitvifes as finding partners with products in a 
certain pnce nange or avaifability, orfinding high quality partners with good reputefions. The data in 
UDDi is fwt sufficient to accommodate ttjis because of i*ie cross category issues associated with high 
vdurnes and voluntary dassificaijon. 



lid Structum Sp«cif!ca1jo« 



Cf^yright ^ 2000 - 20C2 ay Accertture, Ari&s, inc , Cammercc One. tns: i=«i«stj limHaii. Hewiestt-Psckgrd CowBany. >2 27 
TsshPOiogiss. mc . irst* Cofpofaiion, (tKsmaiiOiia! Business Machi«s« Cwporsiion, Micfcsoft Ctsfpcs-iation. Oracs^ Corpofatior', SAP 
AG. Ssjn Micffwyssenis, t«c.. &m VeriSigfi, Irso. AS Rights Rissswvec}. 



UCiJ' V"-?'t}r> r Daw St' Jctwe SBcaf)C3-fa'-s 




From tHs stmctuns deftntSor? we see thai c^^gryBag is an eisment that hdds zero or rnore fnstar*ces 
of keyedReference eisments. This was descrtbed m {he section on identsfers {^pendoc A- Using 
tderitifiers) and the basic steture is traed in the same way. 

Three categotizatton taxonqmiesf have been identffied and made a core part of the UDD! Ope-stcr 
registries, so fer. These are file Hom Amefican Industry Ciasafication Sysfen^ ^Nt ASGSV", Univaso! 
Standard Products and Services CiassfficaUon (UNSPSC)'*, and (SO 3166''. the sntemabonsi 
standard for geographicai regions, insEudir^g codes for csuntriss and nrst-tevel admirtistraijve 
subdivisions of countries. A fourth cat«igory is also deiined - named "aber Taxonomy" -for ger^eraf- 
ptirpose keywojid type ciasstication?*. 

The tMqde! names for these taxondmiss are 



Taxoiionsty NametiWIodei name 

NAICS ntia-gov ;naics; 1 997 

UNSPSC3.1 unspsc-<;rg,un3i3sc:3-1 {dspri 

U.NSf>$C unspsc>org:unspsc 

ISO 3166 uddi-Ofg:iso-<:h:3166: 1999 

Other Taxonomy uddi-iOrg;gener8Lkeywofds 



OpsfaiOf Sites arc siowftci to fsrwFioie mvm fisiBgtST,- enaiss, or mt'm ttiat am cShsfwiso rejacied by me category 
cJassiTicaSon seniioiss, so this ii<isc«!;aneoijs isjoitiM-ny. 

Ccpyfjghi © 20G0 - 2G02 by Acc^rtiure. AriSa. inc.. Comf»e»cs Or^a, Inc. Pxmm Uniieti. Hewiett-Packsrd Cofnpany. i2 2S 
Teci^nctogsea. fnc . inte! Corpofstien, irsSemaSonaf Business Mact-iiftes Ccs-pcfaKors, K'Sscosoti Corpts-atioii, Ofscte Cofijoraiion. SAP 
AG. Sun Microsystems, inc., and VeriSign. ms. Aitftighi^ i^«sm'e<S 



UDD! Vs-rsifjr. 2 Data StfucUBe Specific?*fjn 



12 Apyiemiix C: Resfionse message reference 



Ail of ihe messages defined in the UDDi Version 2.0 APi Si2ec(;i::«i,on return tesponse messages upon 
siicoessfu! compieUon- These statctures are defined here for reference purposes. Ail of the stfKcfures 
shovwi will appear witNn SOA!? 1,1 eomptiant ewe^opestaietiJres ecccs^ihg to th^^ 
descaibed in the appencJices for the UDDI V^eibn 2.0 AP! Speeificafion. Only the SOAP ^Jxjdy> 
element conter^ts are inltie ©leamf^esin fliis secSon, 



1 2*1 sts5erllor«St»tus!%e{j<»rt 

This message returns z&m or mcsre asserSonStatusfJw s&iicrut^s ifi response to a 
gergssertionSiatu^eport tnquify message. 

< asss«r!;iSnS.-!.air.:;sSsport s<6Beris«''S , 0" og«r.c^toi.»<r udsJi. somsaperstisx" j-imlns.--" utK ; - 

This message reports ail complete ertci incomplete asserfions and serves en adminisirative use 
including Jhe delsrminertion if th^ are any outstanding, incompiele asserllons about reiatfonships 
snv«vfng businesses the publisher accourtt is associated v«»i. 

Since Ihe putjf shsr wi to was auther^caied by ihe get„assettionStatusRepoft message can manage 
several businesses, ti^e .assertic»TStatiisReport me^ge shows the assertions made for all busine^es 
managed by the puWisher. 

WhtSe the eJ^ents framKey, toKey and keyedReferenee together iden^tiie assertion whose status is 
being reported tie KeysOwned element designates those buslnes^eys the pubBsher rtiana^. 
An assertion is eompSete onlir if the ctsrnpietionStatus aStiibute says so, tiat is, having a value 
"si:?ites:complete" if cxjmfrfefJc^Status has 3 Value ■status;toKeyJncQmfrfete' or 
'■status;franK6yJncon"(p}ete"*. the party who controls the busihes^otity mferenced by fiie toKey or the 
fromKsy has not made e matdilng assertion, yet. In the example we can see *at the' patty who 
cordrois the businassEniity -with the lx^nessKeyA237B,.. has not made a matcNng assertion tothe 
one found tr, the a«.sert:on3tatus!to, mads by the party who controfs the businessEntity with the 
businessKey F5E65,,. , 



Thfs message retu-ns ^e authentfcato mfomiafeon that shotild be used tn subsecjuent calls to t!"e 
publishers API messages. 

12.2.1 Sampte 




Ctj> >"i9htg?20iX(-^032 ay 'Xcaenitir* A'*a fnc Coiir^e'reCw 'nc FjjS=,t Imu'ec he,w««« o .k r{3 Ccs^yipany J 29 



The at^ToKen message contains a sin^« atJthinfo efement thai contains an access token that is to be 
passed back in atl Publishers API messages that change data. This message is aiways returned usir^ 
SSL encryption as a syndironous response to Sie gst„3uthToken message. 



""h <4 mp'isage returns specific bindinglemr^ate informetson in response to a 9et„btnaingDetaii or 
f!nd__bjndjng inquiry message. 

12.3,1 Sample 

•>bjriaiTisX»fitpX:SES fc5n&ia5SS!Vr»''?SE65~,'' &ejfvics>SCsyi»»E435S.:.'' > 
■; / a.i Ka A «a(yeiHjfl.».ti8 > ■ 



in {! -I's'^'iaqe oiif^ or 'pntB bindtngTempiats structures are nstumsd according to the data tequested 
in ' -..Qi k--f i > n< ^c,g^ -^e se'Vf.eKey attnbutes are always returned when bintiingTsmpJate data is 
n this v i hf itx ,5*u < f]ag shown in the examf^s indicates that not all of the requsisted 
aaia t^^jinf o dd »u i ...n-^peafted ptocesstng femit Ordinaniy, the to::at«d flag fs not tnduded 

ynisss the resuit set nas been truncated. 



1 a^fetssK^essOetaB 

Tbts message returns one or more conripl^e bUKnessEnttty staietun^ tn response tc 
get kjsfFfessDetatt inquiry message. 

xl;^^a^^ ' lir Ti : v,CJ,<ii -org japi_va-'':> 



Jn this message, we see that the bu^nessEntity contains the; prop®- output information <e.g. 
authorizedName, and operator). The two opemtor attributes ^own in tt^ businessOetal! ^mient and 
the businessEntfty eJemer^t n^ect the distinguished name of the Operator Site providing the resjponse 
ni8ssa£^ and the disfinguished name of the operator where the data is canirolled, respectively. 
Addifonally, notice lbs name of tfie person who registered the data shown in the auttorizedlMame 
attribute. 



1 ZS SsissinessOetailExf 

Thfs message returns one or mons compiete ijustnessEntttyExt staicttires in re^jonae to a 
get^businessDeiailExt inquiry message. This Is *e same data returned by the businessOetai! 
messages, but is provided for consistency with tiiird party extensions to businessEntity fnformation. 

<bijsiT!es.tBt,>«r,<-in.!5xf. ge«sT.ie»-'2.0» o£ser4t£sv.-»''a,'fdi .soyjrcsOp^rator' !:x:uJxas'os<j="fcr'u«'' 

CopyrsfjfU © 2000 - S002 by Acceoiute, Arfea, inc. Commsroe Ofie, inn FujS&u lhm*sti. Hew!e8-Packard Company, i? 50 
T«c!-->ioie!(i!(ai, inc. insei GosporaJion. ii-itef:«tior'Sl Susmess Masmrses Cofiwatiori. Micesofi Coft'oraBOfs. Oracse Cofpor.^tion SAP 
AG, SMrt ^'Sic^{>svs^ems, inc., &m Veri&gfi. inc. ASi Rights Resetve<j, 




Thf» nr>e<=V3Q(: 'vr d-s.i}n «!lowt> third party reqt<;tnes (e g fion operatJor site's) to 'r«pteTient {he UOD! 
Vc sion " ■) APi Specfficattons v*fte a* the sarre ftme exte'idtry the iJetatis collected in a wav iha\ vwli 
t ot V j,^ iools th?4 are A-nRen to UDDJ t^jecificatiorss Operator Sites am rsquired to ajpport the 
f ot i }!-<-■ 1 n)'^ fx bsDetasI message fer ccmpatbiltty vwth tools, but are not aflowed to manago 

extended data. 



1 2,6 bsissnessLsst 

Ht nt»ssagerf>tii n-^^ t nv^se !3uyres-.f!iro<5truck)t«i.in(esponsetoaftnd business inquiry 
me^'ssu'" nt sisfr o ^r^n arc abbie\. fated versions of bustr^essEntfty d^a suitable for 
lopt. atng HiS of searrh results ip antopafeon o^ aifther"{ir!il-ciovvn' detail fnqumes 

12x6.1 Sample 



""iK Tipssa le rc'L ever inht form of ^e^oo'•mo'Bbu«!lnes'^!n^r cstniciui ^ ac-» 

ttu^i-^* M o < ) KSi.'-manvn-^meo.id optional dei»C!riio-i US'-' -jj. in .coi.ecton 

e cnrroi J < V if - 1 -"S i! i i w t contrftnone or more 68^ c in'osnicnia, hotcethat 
U bt it >s ! f , j-ttii. { ts !ic t i xp e<;*.=>o i-^ he servjcetnro sirudufo rfo« to the r^n ii at ! ir 
intomsaiion is; avadaUie srom the containing bustnessinfo stfUCture 

'Hms -^ots. t^ta) s.n<ea (.eln n -.tn<ctuio oan rcpr^^entaprojectwto sdeteted pb'itnrfes^yfvi^e 
the name ei^n lent ^^st^Hr the service! tfo struct jre s Dptsona! (see s^tion 4 4 1 3 3 ot the V 2 APi 
Speetftcation on ctefeUng prqected ^rvieesX 



T ht.. messuage returns! z&to or more pub >shcr h-^*?-? sfructur^ to msponse to a 
set. pubiisherAssertions or a get^pjbftsherAssefiions publishing message. 

ia.7.1 Sample 



^ Kefer so me UDl5t XMl schsim tor ssnscture deiaiis. 
•"uoyq'i CCODO 2<C2tfvA'-Cfn<iit A'! tor Cimme ce s^n^ Inc Fv, U h*>ww P«(C\< ra ' o-jio^rv 
AS, Sun Jv-liwosystems. irtc. snd VsriStgn. inc. AiS Rigtiis Reser\'ccS. 



This message dgtums aif assertions made by the putdisher who was authenticated in the precs<3in& 
set .pubJtsherAsserlions or the get^publisherAssertions mes^ge. 



This message retums ovetvSaw informatfon «i8t fs suitable foridenSfjflng ati businessEniJly and tModei 
data published by the requester. Provided as part of the Pubtfshsr's API message set, this infomiatlon 
is onfy provided when requested via a getfegisteredinfe message over an SSL connediort. 
12.8,1 SamjJle 



•: /service 

--•.••CMadsl Ififfti 

:ictf}tS<3«!llJl£«t/»„.l .■: ■ ■. ^ ■ ■ .i ' . ■. . .. 



This message contains overview data about business and tMode! information published by a given 
piibissher This infonrtaiiDO <s sufficient for driving tods that di^lay itsts Of registered infofmate and 
then provide drill-down features. This is the recommended stnjeture for use after a netwffl* probiam 
results in an unknovi'n status of saved informato. 



1 2.Sre!latec!Buss«essestist 

This message; returns zero or more relatedBusirtesslnfo structures in response to a 
Rnd^relatedBu^nesses fnquify message, 

12,S.1 Sampte 



k.;y!,i.>:i'f<.-.-'s;«bsifii.i»jrv''' 

efiS«sj.riaf.:sIsiE?3e» 



Cop-yfight ® 2Q0Q - 2002 cty Ascfinturs. Arifoa. fn« , Cammeroe OfCJ, !f>s, Fsjiitsu Lmi&S, Hewfeit-Patksrd Company. i2 32 
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AG, Sufs Microsystfifns, inc., and VeifiSien, int.. Aii Righss Reserwsci, 



UDtSi Vstsiori 3 s>8!s Sirucfere Sp^eiScatW! 



K-or ihe !:iii?jness.Ent(iy specified m the find jelatedBusinessDS, tn's strijc-ure repons compiete bustn?;!^ 
reiafcfjships wim other bustnessEntiiy registrations Business rtjiationships are compiete between tw 
buanessEntttv registrations when fhe pubiish^'-s cgntrolling each of ihe bussnessHntily sfructures 
invdved m the relationship set asseriians afiifTr>!ng ihat relationship 

Eao'- fdgteciBjiinesslnfo stnjci!.;;e co--,--f < -v^-T; a.-y.A 3 busirsessEntiiy ihat rf^iates to the 
sper,fi.?d LiUi:(r^<335E;nttEy {y <5t iea« or.:- : e x o-s'; r b ■'crr^gfion about the ;^iated bListness£ntii-> 
composes its pusinessKey. name ant! opjtons: cescnpticn dara, along wth a coiiecion elemsnt named 
sharedReiatior^ships that in {um can contain zero or rrsore keyedReferenr,e element? ] hose 
keyedReference dements, together \Mth the bussnessKey e!emftr!t& for ;,:x>cifiycf and the related 
busfnessEntity represent trie complete reiafionships, thaf js, matching puDhsher assertions inacie by ttie 
publishers for each busirtessEntily. Since the related businessEn% can occupy either stde a 
r.:!iationship. tns sharedReiatlonsNps element is adorned vvith a direction attribute, tn the ejtampie 
cibovf;. Mm 5 G^mge is the toKey, that is, the chflcJ of the parent-child nelatloriship to the business with 
theksy'F5E65.,;', 



1 2,1 0 s^rvsceOetasI 

Tt^is message returns one or more cornpiete busine^Setvice strudures in response to a 
get^serviceiaetai! inquiry message. 

12,10.1 Sample 

Ars«8S,'5ervs.>se> 



One can lise serviceDetatI messages to get cors^plete dsscriptwe and techntcai detaiis about registered 
s<?fv ioes by pnoviding one or rrtore setviceKey vsJues in 8ie getjseft/lceDetait message. Notice that the 
bu&tne.-3sKey vaiue is expressed in iNs message because the container does not pfmide 3 tibtt to ti\& 
parent businessErvtitystnieture. 



12>11 sesvlceList 

This message returns zm> or more s^'pelnfo structures in response to a find^sefvice inqiSry 

message. 

12.11.1 Sample 




Sr « n^o <^ja.f-t } or-- abbreviated versions of businessService dfeta suitable for popufatng a ftst of 
se, ' f K .'bso' s<fis\ tth business and that matc^i a pattern si& i^jectiied m the mputs to the 
fi'-'J sef\ it%.qe Nr tice that the buynessKey attnbue ts expiessed tn the setvfceinfo elements 
D J! 1 1 n *h V fnes=cq<^ " -^is is ! tecauoe this ipfotmation is i sot <• ' iiao e 'rom a oontatbfng element 
Stpc^ a -it eir stfLctttre can repteijent a projedson to - •< L ;nessS6nrtce, the name 
e:&ri [ <^ /\Hm <he sefvicefnto stri^cture 's optiona! (si,e cctfon A' 13 o ihe V2 AP! Specification on 

C«pyi'<n,«. AOT '"!')?^v^ >1* j'^ Arii>f fix "onn«tcrCne h>jHvS.i I imit-NM ewie" Pa^Karrf Co.Tif.3t v t"^ ^'i 
Ttr,f.tioo'iif-^ trc it > Oft^x'- 3 if ef , tto v! SjMfes,^ M ivt tre« Cwpcmw!^ 'OiOff Tow diic f Or&c s Corpvsinsn SAP 
AGl, Sun S.te05ysfetT>s, tfw;„ and VcDSjien. irsr.. AK Riqte Htis.etvy.cS 



deletirig projected services). 



12.12: tlVSocieilJet^i! 

This m«:ss,ai:(e reiums one or more cotT5p(ete S^odet strucfejres in tBsponse to s getjModoiDstati 

inquiry n^essage. 

12.12,1 Sample 

■;i.;-tedft;iCsv^i.ii. sc;5-s«Kic.-=--i,0~ cpf^r8tOir'«^'wa<fi , sOJii-cfeppera {tir»-ti.cafc«^«"f &is«!»J 

opera c»r»"«rfrfx.p«fciis^ii«gK>pejr*i-;(>jr'' v: 



Because tf.lods! structures aretop^evei.cigta (Siat is, stand alons wth no parent containers) the 
autnonzecJName value is expressed. This is the name of Sre person whose account was used to 
register the data. The two operator attnbutss each express *e distlngtashsd name of the Operator Site 
that is pfwtdingtiie data and the c^)ef«ftor \vhere the^ d^^^^ mahsged. 



12.13 tl!S0clell.fet 

This message Mums x^o or more tiVtodeffnfo struotures in ngsi^me to a find„SV{cidei inqufry 
message. 

</tMiSfiaIs:r!^oa.: 



The tModetJrtfo stiiJCiyties are at^rBviated vefsions of tlV!odel data mjitable for finding candidate 
IMpdets, pqpuiaSng (fsts of results and then pfWitingdHii^ScMn feartyres that reiy on the get^xxDetaii 
messages. 



CdpyfjaSK © seoe - SOOa sy Asssnturs. Ariea, Inc. ComffiBi^e One, inc. Fojifsu Lti^iiSeri. HewieM-^'aoford Company, i3 34 
Tew-!r>ofogf«js>, Inc., m(«! CofpOfanon. i^smsiirinai business Machmes Cwsjoratson, Mirfosoft CofiJorstiors, Or icfe Corpcratte. SAP 
AG. Suf! MiofCiSysiems. Sfsd VenSisn, WC. AD Ri^WS Reservsd 



13 Apiiemiix D: Data Fieid tengitlts 



The foJiowing iabie summarizes 3t! known stored Biement ana afinbute names based on the names of 
the Mds defined io the XML schsjma. These are the storage length iimits far informatiori that is saved 
in the UODI regisSy, given in Unicode charaders. The Operator Sites w!j tasncate data that ^ceeds 
these lengths. Reids that are generated by the Opsfslor sfte (ignored on input) are not iisted. are 
Ssted even though they are generated. Since Keys are referenced by other stnjcttjnes, they are $ho\W) 
here. 





Length 


&sc6$sPolnt 


255 


s<kir&ssLim 


80 


sinfilnfa 


409^ 


aL'ihon^BdNarna 


255 


ImasngKey 


4i 




41 


description 


255 


dismmryURL 


2S5 


em&S 


2SS 


fromK&y 


41 


hostingRe^iPsdor 


41 


instsnc^'Pams 


255 


kevName 


255 


key'Tym 
keyVak/e 


16 
25S 




255 




255 




255 


pfms 


SO 


mvfcoKey 


41 


sc^Cade -. 


10 


tModelKey 


255 


toKay 


41 


upioadR^ister 


265 




16 


vs&Type 


255 



Copyright © 20fX} - 2002 by Afcsdtiife Ar-oa, tnc , COfRmerce Om, !nc. Fisitsu lirm;^. HewieS-Packsr^j Company, a 35 
T«;h! -sgo-? itv !r;e Co po -itFCi ifi.strto,; na Sowress MacNpBS Cofi>f«t.or Co'!)or<jito) Drac t^cpcafw SAt 

AG, Sufi Microsystems, inc. and VeriSigfi, !rg. Aif Ricjfm 8es«fve<S. 
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14 AiipendixE: Structured Address Example 



The address structure. c»ntatned m the businsssEntity structure, contans a simple Hi of addrsssLine 
elements, Wjiie this is useful for pubB^tng addresses m a UDD! registry ac simpiy printing them on 
paper, the address' sSructure and meaning remains hidden for a given businessEntity. For this reason, 
address ^ructufes can be adorned virtuatiy vrfth keyedReference etemerits. In fact atMod^Key 
stttibute can be provided for an adds^s stmctung and keyMame iteyVaius attribute pairs cstn be 
provided for mch acidre&sLine eSement This sxampie is provided to dmionstfate how the application 
of tA'lGdfjiKey. keyName and keyVaiue ateibutes to address structures can be used to give sfwcture 
and rtieaning to a given address. 

Let us assLiiv.e fhat a canmunlty of several countty-spedfic postal agendes, ca«ed "IBCPA', not 
exisbng in reality, agreed on a core set of address components for exchanging data eJectronicaiJy, TNs 
set cunentiy comprises the components Street, Street number, Postal code. Ctfy, District, Region and 
Gountry. 

in order io maite these address compot^ents availabie for^eir use in UODI ad<*ess stojctures. iSCPA 
assigns a unique value (10, 20.-,.„ 70) to each address component and publishes a tModef vwth a 
saveJMpdel mes^gecait that contains a tModet structuf® in the foSowng fonn. 

«!5aBerip<-,i£jn kwI : li5«g.-.''fra*iC«^5a for S^adsess Cosiportf^jsts (SeSineii by ths lrs^txs:\&^.tM&l 



iBCPA sets back the tModeiKey A548., As a lesuit, the iBCPA set of addngss components c^n now 
be used by every pirfjli^er to stnjcture Sietr addresses !n bisinessEntiiy ^rudures. The fc^owng 
example shows an address structure using the ISCPAtMddel in a savejDUSir^ess message call. 
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